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PREFACE 

When one thinks of computer^oriented graphics or displays, one can con- 
jure up various images, from simple graphs of data to flow charts to 
orthographic projections to dynamic real-time portrayal of information or 
data to complicated animated movies. Behind these exciting visual pic- 
tures which are drawn or projected is a maze of programs and routines 
which transform raw data into the exacting movements of the display 
device . 

These routines fall into a broad spectrum of capability, complexity and 
ease of use, from complete plot packages with little user decisions on 
one end to routines which move the drawing instrument one increment. 
The Graphical Display System (GDS) stands above and in the middle of these 
two extremes. It is a set of subroutines which produce fundamental graphic 
entities independent of any given display device. 

By being concerned with the basic elements of a display, such as 

a grid in data representation graphics, 

a rectangle in diagramatic graphics, 
or a projection in three-dimensional graphics, 

GDS allows the user freedom to choose his plotting parameters without 
resorting to detailed descriptions of the movements of the display tool. 
The routines may then be used as tools in constructing display packages 
for particular applications. 

By being display-device independent, the Graphical Display System is above 
the routines of the plotting spectrum which are usually designed to work 
with one specific display device. Programs written using GDS routines may 
be used within restrictions (most are imposed by the surface area of a 
display device) on one display device or another with little or no change 
in the program. 

Display-device independence is achieved by describing the graphic entities 
in terms of basic plotter movements or directives which are placed in an 
intermediate storage device or file. These movements are then transformed 
to actual plotter commands by a second independent program, called a 
post-processor, which is designed for a particular plotter. 



Experience has shown that the GDS philosophy is sound. GDS has been 
successfully implemented on several computer systems and for a number 
of display devices. The Graphical Display System has proven to be 
flexible yet stable in the fast-changing computer world. 

Acknowledgement must be given to Messrs . Charles Dickens and Don Ruchman 
of the Boeing AeroSpace Division who originally developed the GDS concept 
with their Numerical Plotting System. Messrs. David Hussey and Art Paradis 
have brought GDS to its current stage of development at the University of 
California, Berkeley and are currently expanding Graphical Display System 
to include interactive graphics. 
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Introduction to Plotting 

A. Introduction 

Welcome! The purpose of this section is to demonstrate how to use 
the "Graphical Display System" (GDS) by explaining what it does, 
how to use this manual and by presenting a complete example. 

B. Purpose of "Graphical Display System" 

The "Graphical Display System" is a flexible method of data dis- 
play via automatic plotting machines. In proper perspective it is 
but a topic under the general subject of drafting. A few familiar 
examples of graphical representation of data are: 

1. Rectilinear graphs 

2. Logarithmic graphs 

3. Semi-logarithmic graphs 

4. Polar graphs 

5 . Nomographs 

6. Contour Maps 

Traditionally, such graphs and maps are produced by a combination 
of manual and semi-automatic methods. V'ith due respect to those 
conventional practices, the Graphical Display System affords its 
users a competitive plotting operation, one that complements a 
computer-centered data reduction operation. 

C. Anatomy of a Plot 

In general, six basic components of a plot must be considered and 
specified in order to construct a suitable finished plot: 

1. An appropriate coordinate system must be selected, whether it 
be polar, rectangular, or of some other type. 

2. If the selected coordinate system is rectangular, the scale 
type for each axis must be chosen, whether it be linear, log- 
arithmic, or some other function scale. 

3. The coordinate system frame may be either an axes pair or 
a grid, plus any supplementary axes. 

4. The scale range for each scale must be defined. 
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5. The data representation on the graph may be either by plot 
lines, curves, and/or plot symbols. 

6. Ample annotation is needed to finish the plot. 

"Graphical Display System" Organization 

The Graphical Display-System employs two steps for generating plots, 
namely, the Graphical Display subroutines and the plotter-oriented 
post-processing programs. The Graphical Display subroutines are 
independent of the plotter. These routines reduce the plot specifi- 
cations into general construction codes for input to the post-processing 
program(s). The purpose of the post-processing program is to translate 
the general construction codes into a series of plotter-oriented com- 
mands that drive the plotter to construct the plot. 

Graphical Display Subroutines (Step 1) 

The Graphical Display subroutines constitute an open-ended set of 
graphic routines (routines may be added) written on many levels and 
for many types of computer graphics. 

The description of the routines are first separated into different levels 
(complete plot routines, component plot routines, and basic routines) 
which will enable the user to select the degree of versatility he wants 
and the degree of effort he wishes to expend. These levels are then 
grouped into different areas of graphics (general routines, contouring, 
diagramming, 3-D plots, etc.). The following table explains more fully 
the purpose and scope of each level. 

Complete Plot Routines — These routines are for the person who 
wants an easy to use, painless plot program. Each call produces 
a complete plot. Most of the decisions such as axis length, type 
and amount of annotation, etc. are predefined. These complete 
plot routines are grouped into areas of plotting (general, con- 
touring, diagramming, 3-D, etc.). The general index and the 
chapter entitled "Short Guide to Plotting Routines Available" 
contains a list of these routines. The write-ups for these 
routines will be described in a separate volume (extended chapter) . 
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Component Plot Routines — These routines offer a great deal more 
versatility than the "complete plot routines". Each call produces 
one component of the plot (i.e., grid, data line, axis annotation, 
title, etc.). These routines are combined into one coherent set 
of routines by the use of a general plot specifications array 
(SPECS) . These routines are grouped into different areas of 
plotting (general, contouring, diagramming, 3-D, etc.). See 
the general index and the chapter entitled "Short Guide to Plotting 
Routines Available" for a list of these routines. This manual 
contains the descriptions for the General User routines. The routines 
in the other areas of plotting will appear in separate volumes 
(extended chapters). 

Basic Plot Routines — These consist of the subroutines used by 
the "component plot routines". There are two general sub-classi- 
fications — utility routines (character packing, etc.) and low- 
level component routines. The low-level component routines are 
characterized by more complicated calling sequences and control 
over certain plot specifications (i.e., length of tick marks). 
See the general index and the chapter entitled "Short Guide to 
Plotting Routines Available" for a list of these routines. These 
routines will appear in a separate volume (extended chapter) . 

Post-Processing Programs (Step 2) 

These programs translate the general plot construction codes generated 
by the above routines into plotter oriented commands. There is one 
post-processing routine for each plotter available. See the chapter 
entitled "Post-processor" for a detailed description of each post- 
processor (this volume). 
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E. How to use the GPS manual 

The manual is divided into the following chapters: 



Chapter 


Title 


I 


Introduction 


II 


The SPECS 




Array 


III 


Short Guide 




to Plotting 




Routines 




Available 


IV 


Graphical 




Display 




Subroutines 



V Post- 
Processors 

VI Control Card 
Usage 

VII Diagnostics 



Purpose 

Introduction; guide for use of manual; 
complete example. 

Detailed description of the SPECS Array: 
The SPECS array is used to specify the 
various plot parameters (i.e., axis length, 
scale range, etc.). 

A list of plotting routines available: 
The routines are grouped according to 
function and a small description of purpose 
is given for each. 

Write-ups for the individual subroutines 
grouped according to function: Each group 
has an introduction which gives the purpose, 
method, and restrictions of each routine. 
Each individual write-up states the purpose, 
calling statement, explains the call list 
arguments, and gives an example or diagram. 

This section has one write-up for each type 
of plotting device. 

This section shows which control cards are 
necessary to run your program. 

Description of error checking (in post- 
processors) and diagnostic aids. 



Although the manual is large, it is intended to be easy to use. When 
using this manual, the user should follow these steps: 

1. Formulate his plot requirements (i.e., plot type, size, annotation 
required, etc.). 

2. Make a sketch of what he wants the result to look like. 

3. Check the post-processor write-ups to see which plotting device 
best suits his purposes. Note any restrictions or options 
associated with that particular plotter. 

4. Check through Chapter III (Short Guide to Plotting Routines Avail- 
able) to find out which routines he needs to produce his plot. 

5. Then turn to the individual write-ups. Refer to the main section 
associated with that write-up for a description of the method or 
restrictions. See the individual write-up for calling sequence 
and an example of usage. 

6. The individual write-ups list which elements of the array SPECS 
are needed. Turn to Chapter II (The SPECS Array) for a detailed 
description of any element of the SPECS array. 
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7. Setup and make the calls for the different plot components (i.e., 
grids, plot lines, annotation, etc.). 

8. Refer to Chapter VI for control card usage. 

9. Diagnostics are discussed in Chapter VII. 

Good Luck when writing your program! 
F. Complete Example 

P PC G KAM~PLCT(CLTPUT,T*PE99) 

REAL SPECS (30) ,X(5C) ,Y(5C) ,BUFX(5CC) ,ELF Y (500 ) ,GI VENl 3 ) 
C SETUP SPECS ARRAY 

C S£T XDISI.YDIST 

SPFCS( 1) = 1.5 

SPt=CSt2J_ = 3.3 

c "sirr - ? nHTTV xltft " 

SPECS! 31 = 360. 
SPECS!*) = -3cC. 
C SET XLNGTH, YLNC-Th 
3PECS(7> = 8. 
SPFCS<3) = 4. 



C ScT XDIV (YCIV WILL BE CALCULATED EY FABLIY) 

SPECS<9) = 8. 
C SPECIFY TUOL 

sp-csui) = 1. 

C SPECIFY INTEFMECI/TE FILE NUMBER 

SFf_CS<12) = <3S. 

f. PulNTT *TLL BE SP"EU~rC"' LATER 
C SET XSKIPSt YSKIFS 

SPECS<14) = i. 

SPECS (151 = 1. 
C GENERATE SCME DAI* 

DC 10 I = 1,31 



DfcG = -364 ♦ 24*1 

RAD = OEG*0.0174532S25 
XU) = DEG 

Yd) = 2.*SIN(RAD)+CCS(2.*R/C) 

10 CCNTINUE 

SPECIFY FCINTS 



SPFCSI13) = 31. 

FIND THE MIN AND PAX 
YI«IN = Yd) 
YfAX = Yd) 
DC 20 I = 2,31 
IFIYU J-YNIN) 12,20,15 



12 YfIN = Y( I ) ~ 

GC TO 2C 
15 TF{ Y{ I)-Yt*AX) 20,20,17 
17 YNAX = Y< I ) 

20 CCNTINUE 

_C SETUP TFE GIVEN ARRAY FCF FABLIY 

JTVE'NI 1 ) ="" YHAX " _ 

G IV EM 2) = YMIN 
GIVENO) = 6. 
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C FA6LIY FINDS A NICE Y SCALE RANGE 

CtLL FABLIY(GIVEN, SPECS) 
C GCLILI CRAhS THE GRID — NO TICK MAPKS 

CTLL GDLILI(SFECS) 
C SPECIFY THE SYMBCL NUMBER 

SPFCSU6) = 1. 
C SPECIFY CHARACTER SIZE 

SPFCSC17I = 0.1 

SP£GS(1 8) - 0.1 

SPFCSllSJ * J.U 



C_ SPECIFY THE ANGLE CF LINE ROTATION IN CEGREES 

SPFCS12C) = O.C 1 

C SPECIFY THE FONT TYPE "~ 

SPECS(21) = 1. 
C SPECIFY THE NUMBER OF CECIMAL FLACES 

SPECS(23) = 1. 
C I NITIALIZE THE ZONE VALUES 

'SPEC'S (24) =0.05 ~~ 

SPECS(?5) = 0.C5 

SPFCS(26) = 0.05 

CALL NOCLIE(SPECS) 
C NUOLIL MJMBeRS THE LEFT AXIS TO SPECIFIEC NUMBER OF DECIMAL PLACES 

C A LL NODLIKSPSCS) 

"C" RESET TFE NUMBER CF CIVISICNS FOR TICK MARKS 

SPECS (9) = 72. 

SPECS! 1C) = SPECS( 10*10. 
C AXLILI CRAViS AN *XIS PMR WITH TICK MARKS 

CALL AXLIL KSP5CS) 

C PSLILI PL OTS A SYMBCL AT EACH CATA POINT 

C~7LT'"P5LILHX.V.SPfcCS) 

C PFLILI CRA*S A SMCCTH CLRVE THROUGH THE CATA PCINTS 

CALL PFLILI(X,Y,BUF> f ELFY,SPECS) 
C 35SET TFE CHARACTER SIZE 

SPECS! 17) = 0.2 

SPEC S( 18) = 0.2 

~C T ITLEB CONSTRUCTS A EdTTCM CENTERED TITLE 

CALL TITLEB(12HX IN CEGREES .SPECS ) 
C TITLEL CONSTRUCTS A LEFT CENTERED TITLE 

CALL TITLELUHY.SPECS) 
C TITLET CONSTRUCTS A TCP CENTERED TITLE 

CALL TITLET(23HY = 2*SIN(X) + CCS ( 2*X ) , SPECS) 

"X RESET TfE X UlVlblCNS FL'R A SUPPLEMENT ARV AXIS ! 

SFeCSO) = 16. 
C RESET THE NUMBER CF CECIMAL PLACES 

SPECS(28) = 2. 
C SAXLI8 CONSTRUCTS A LINEAR AXIS BELCfc THE PLOTTING AREA 

CALL SAXLIE(SPECS) 

C RTSET XPlGhT ANC XTETT — 

SPECSO) = £.283195 

SFECSm = -6.2831S5 



RESET THE CHARACTER SIZE 
SPFCS117) = 0.1 
SPECSU8) =0.1 
CALL IMCDLTE (SPECS) 
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SPECS(17) = 0.2 

SPECS (18) = 0.2 

CALL T!TLEBfl2HX !N RADIANS SPECS^ 

SPECS (17) =0.1 

SPECS(18) = 0.1 

SET X START AND Y START 
SPECS(22) = 5.25 
SPECS (23) = 1.5 
RULE = 1.0 

SYMKEY PLOTS A SYMBOL AND A LINE OF TEXT 
CALL SYMKEY (1..18H CALCULATED PO I NTS, SPECS) 

RESET YSTART 
SPECS (23) = 1.3 

TITLEG CONSTRUCTS A RANDOMLY PLACED LINE OF TEXT 
CALL TITLEG(1.,30HPFLILI IS USED IN THIS EXAMPLE, SPECS) 
SPECS (23) =1.1 

CALL TILEG(1.,30HTO DRAW A SMOOTH CURVE THROUGH .SPECS) 
SPECS(23) = 0.9 
CALL TITLEG(1.,21HTHE CALCULATED PO INTS, SPECS) 

GDSEND MUST BE THE LAST PLOTTING CALL 
CALL GDSEND (SPECS) 
STOP 
END 
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Example of plot from PRINTR post-processor 



jL 



1.0 



-1.0 



-2.0 



Y = 2*SIMX) + CCS( 2*X) 



.". 1.1. 



-3.0, 
-3 6 3.0 



:.l.".l 
.1. 



1, 



-27C.0 



1 



.1 



..1.1. 



• • • 

..1 



-18C.0 



-90.0 

X IN DEGREES 



90 



..1. 
.1. 



lao.o 



270.0 



360.0 



-6.28 -4. 71 -3.14 -1.57 

X IN RACIANS 



1.57 



3.14 



4.71 



6.28 



1 CALCULATED POINTS 
FFLILI IS USED IN THIS EXAMPLE 
TO CRAW A SMOOTH CURVE THROUGH 
ThE CALCULATED PCINTS 



Example of plot from CALCOMP (Model 565) post-processor 



Y = 2*S I N C X 3 + CO S C 2*X 3 



Z. 



>- 




- 1 . 



-Z .0 



270.0 



X IN DEGREES 



3*0. 19 



-I L. 



-«.*• -*.7j -3.11 -1.57 o j. 57 

X IN RADIANS 



— • ■ 1 1 i 

3. »1 4. 7| fi.Xt 



A CALCULATED POINTS 
PFL1L1 IS USCO IH THIS EXAMPLE 
TO OffAU A SMOOTH CtlOVC THP0UCH 
THE CALCULATED POINTS 



The SPECS Array 

SPECS is an array of floating-point values that specify the construction 
parameters necessary to produce the various plot components. Table 1 
presents the format of SPECS and defines each construction parameter; 
Figure 1 graphically illustrates the various construction parameters. 

The use of this standard array by all the system subroutines greatly 
simplifies their integrated use. 



Table 1. DEFINITION OF PARAMETERS IN THE ARRAY SPECS 



Parameter 



Suggested 
Mnemonic 



SPECS { 1 ) 



XDIST 



SPECS (2) 



YDIST 



SPECS (3! 



XRIGHT 



SPECS [4] 



XLEFT 



SPECS (5) 



YTOP 



SPECS (6! 



YBOT 



Definition 



Parameter specifies X component of the 
vector distance (inches) from a reference 
point to the lower left corner of the 
defined plotting area. 

Parameter specifies Y component of the 
vector distance (inches) from a reference 
point to the lower left corner of the 
defined plotting area. 

Parameter specifies the extreme X 
ordinate on the right of the X-scale of a 
rectangular coordinate system. Parameter 
specifies one extreme of the ordinate 
X-scale range. XRIGHT may be larger or 
smaller than XLEFT. 

Parameter specifies the extreme X 
ordinate on the left of the X-scale of a 
rectangular coordinate system. Parameter 
specifies one extreme of the ordinate 
X-scale range. 

Parameter specifies the extreme Y 
ordinate at the top of the Y-scale of a 
rectangular coordinate system. Parameter 
specifies one extreme of the ordinate 
Y-scale range. YTOP may be larger or 
smaller than YBOT. 

Parameter specifies the extreme Y 
ordinate at the bottom of the Y-scale of a 
rectangular coordinate system. Parameter 
specifies one extreme of the ordinate 
Y-scale range. 
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Table 1 (Continued) 



Parameter 



Suggested 
Mnemonic 



Definition 



SPECS (7) 



SPECS it) 



SPECS ( 9 ] 



SPECS ( 10 ) 



SPECS ( J 1 



SPECS (12) 



SPECS ( 13) 



SPECS [U) 



XLNGTH 



YLNGTH 



XDIV 



YDIV 



TOOL 



CCTAPE 



POINTS 



XSKIPS 



SPECS [15) 



YSKIPS 



Parameter specifies the length (inches) 
of X-scale. Parameter defines the hori- 
zontal dimension of the plotting area. 

Parameter specifies the length (inches) 
of Y-scale. Parameter defines the verti- 
cal dimension of the plotting area. 

Parameter specifies the number of equal 
divisions of the X-scale associated with 
the defined plotting area. 

Parameter specifies the number of equal 
divisions of the Y-scale associated with 
the defined plotting area. 

Parameter specifies the use of a particular 
plotter-oriented marking, or printing, tool. 
Normal setting for this parameter is one. 

Parameter specifies the logical file 

to record construction codes generated by 

the plotting subroutines. 

Parameter specifies the total number of 
data points to be plotted. 

Parameter, a positive whole number, speci- 
fies that every XSKIPth value of the X 
array, starting with the first value, is 
to be plotted. For example, if S?ECS[U) 
is 1.0, every value of the X array is 
to be plotted. 

Parameter, a positive whole number, speci- 
fies that every YSKIPthe value of the Y 
array, starting with the first value, is 
to be plotted. For example, if SPECS (15) 
is 3.0, the first value of the Y array 
and every third value after the first is 
to be plotted (until the (P0INTS-1)*3 + 1 
value of the Y array is reached) . 



+ 



POINTS is not necessarily the number of values of dimensionality in an 

X or Y array. (POINTS-l)*[x,Y] SKIPS + 1 must not exceed the dimensionality 

of an X or Y array. 
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Table 1 (Continued) 



Parameter 



Suggested 
Mnemonic 



Definition 



SPECS {16) 
SPECS {17) 

SPECS [ 1 S) 

SPECS {19) 



SPECS {20) 



SPECS {21) 



SPECS (221 



SPECS {2 3) 



SPECS {24) 



SYMBOL 



FONTB 



FONTH 



SPACER 



ROTATE 



FONTNO 



XSTART 



YSTART 



ZONEB 



Parameter specifies the plotter-oriented 
plot symbol to be used in symbol plotting. 

Parameter specifies the base dimension 
(inches) of the rectangle in which a plot 
symbol or alphanumeric character is defined. 

Parameter specifies the height dimension 
(inches) of the rectangle in which a plot 
symbol or alphanumeric character is defined. 

Parameter specifies the additional separa- 
tion distance (inches) between adjacent 
alphanumeric characters that form a line 
of text. Normal setting for this parameter 
is zero. 

Parameter specifies the counter-clockwise 
rotation (degrees) to give a line of 
alphanumeric text. 

Parameter specifies which alphanumeric font, 
i.e., character set, to use for annotation 
work. 

Parameter specifies X component of the 
vector distance (inches) from the reference 
point to a point^ on the line of annotation 
specified. The value is positive if the spe- 
cified point is right of the reference point; 
otherwise, value is negative. 

Parameter specifies Y component of the 
vector distance (inches) from the reference 
point to a point' on the line of annotation 
specified. The value is positive if the spe- 
cified point is above the reference point; 
otherwise, the value is negative. 

Parameter specifies the distance (inches) 
to offset construction below the defined 
plotting area. (Following the construction, 
certain routines automatically increase this 
specified offset value enough to avoid an 
overlap with the next construction below the 
defined plotting area.) 



The defined point is either the lower left corner of the first character, 
the lower center of the line, or the lower right corner of the last 
character depending on a parameter given in the calling routines. 
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Table 1 (Continued) 



Parameter 



Suggested 
Mnemonic 



Definition 



SPECS (25! 



ZONET 



SPECS (26) 



ZONEL 



SPECS (27) 



ZONER 



SPECS (2 8) 



SPECS (29! 



SPECS ( 30 ! 



DECPLS 



SIGFIG 



STAPE 



Parameter specifies the distance (inches) 
to offset construction above the defined 
plotting area. (Following the construc- 
tion, certain routines automatically 
increase this specified offset value 
enough to avoid an overlap with the next 
construction above the defined plotting 
area . ) 

Parameter specifies the distance (inches) 
to offset construction to the left of the 
defined plotting area. (Following the 
construction, certain routines automatically 
increase the specified offset value enough 
to avoid an overlap with the next construc- 
tion left of the defined plotting area.) 

Parameter specifies the distance (inches) 
to offset construction to the right of the 
defined plotting area. (Following the con- 
struction, certain routines automatically 
increase the specified offset value enough 
to avoid an overlap with the next construc- 
tion right of the defined plotting area.) 

Parameter specifies the number of decimal 
places to be used when annotating a scale 
range. 

Parameter specifies the maximum number of 
significant figures to be used when annotating 
a scale range. 

Parameter specifies the logical file 
to be used as a scratch tape by some of 
the GDS routines. 



The file specified by STAPE must be declared on the program card. 
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Table 1 (Continued) 



Parameter 



Suggested 
Mnemonic 



Definition 



The following parameters are used only in the contouring routines. 



SPECS (31) 



XCOLMS 



SPECS [ 31 j 



YROWS 



SPECS [33) 



ZLEVELS 



SPECS (34) 



SPECS (35} 



CGRIDB 



CGRIDH 



Parameter specifies the size of the 
array X which contains the X ordinates 
of the columns for the XCOLMS by YROWS 
grid of Z values. 

Parameter specifies the size of the array 
Y which contains the Y ordinates of 
the rows for the XCOLMS by YROWS grid of 
Z values . 

Parameter specifies the number of contour 
levels to be constructed. The array 
ZLEVEL, which contains the values of the 
various contour levels to be constructed, 
must be dimensioned at least the size of 
ZLEVELS . 

Parameter specifies the base size (inches) 
of a unit grid division of the program- 
generated "contour grid". 

Parameter specifies the height size (inches) 
of a unit grid division of the program- 
generated "contour grid". 



II-5 



ZONEL 



XLNGTH 



ZONER , 

TZONET 




The reference point 



See post-processor write-ups for the actual position of the Reference Point 
on any particular plotter. 

Figure 1 



A Sample Plot Illustrating SPECS Parameters 



II-6 



Short Guide to Plotting Routines Available 



Routines to Determine Layout of an Axis' Scale 

These subroutines determine a layout of an axis' scale when given a mini- 
mum scale range and a maximum number of scale subdivisions. A user of 
either blank (maximum number of scale subdivisions or less) or gridded 
forms (fixed size of scale subdivisions) can utilize these routines. 
Ordinate range and layout limits are given by the list array GIVEN. The 
list array SPECS is the output array. 



Found in 
Section Name 



Call List 



Function 



IV-1.4 



IV-1.6 



IV-1.8 



FABLIX [GIVEN, SPECS) 
FABLIY {G1VEN,SPECS) 
FAGLIX (GIVEN, SPECS) 



IV-1.10 FAGLIY [G1VEN,SPECS) 



To determine for an X ordinate 
range a linear X-scale for a blank 
form. 

To determine for a Y ordinate 
range a linear Y-scale for a blank 
form. 

To determine for an X ordinate 
range a linear X-scale for a gridded 
form. 

To determine for a Y ordinate range 
a linear Y-scale for a gridded form. 
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Routines to Construct a Grid 

These subroutines construct the various types of grids, 
specifications appear in the call liat argument SPECS. 



Construction 



Found in 

Section Name Call Liat 



IV-2.4 GDLILI (SPECS1 



IV-2.6 GDLILG [SPECS] 



IV-2.8 GDLGLI ISPECSl 



Function 



To construct a grid having linear 
subdivisions for both the X and 
Y ordlnates . 

To construct a grid having a linear 
subdivision for the X ordinate and 
logarithmic (base 10) subdivisions 
for the Y ordinate. 

To construct a grid having logarith- 
mic (base 10) subdivisions for the 
X ordinate and linear subdivisions 
for the Y ordinate. 



IV-2.10 GDLGLG [SPECS 1 



To construct a grid having logarith- 
mic (base 10) subdivisions for both 
the X and Y ordlnates. 
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Routines to Construct a Pair of Rectangular Axes 

These subroutines construct a n air of axes which ma'**' bs used s" , *"h ,c *" 4 ~ 
conjunction with, or in lieu of, the grid. Construction specifications 
appear in the call list argument SPECS. 



Found in 

Section Name Call List 



Function 



IV-3.2 AXLILI [SPECS] 



IV-3.4 AXLILG (SPECS) 



IV-3.6 AXLGLI (SPECS\ 



IV-3.8 AXLGLG [SPECS] 



To construct an axes pair having 
linear subdivisions for both the 
X and Y ordinates. 

To construct an axes pair having 
linear subdivisions for the X 
ordinate and logarithmic (base 10) 
subdivisions for the Y ordinate. 

To construct an axes pair having 
logarithmic (base 10) subdivisions 
for the X ordinate and linear 
subdivisions for the Y ordinate. 

To construct an axes pair having 
logarithmic (base 10) subdivisions 
for both the X and Y ordinates. 
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Routines to Construct a Supplementary Axis 



Found in 

Section Name Call List 

IV-4.2 SAXLIB (S?ECS\ 



IV-4.4 SAXLIT (STECSl 



IV-4.6 SAXLIL (S?ECS\ 



IV-4.8 SAXLIR (SPECS 1 



IV-4.10 SAXLGB (SPECS 1 



IV-4.12 SAXLGT (SPECS 1 



IV-4.14 SAXLGL [SPECS] 



IV-4.16 SAXLGR ISPECS] 



Function 



To construct below the defined 
plotting area an X-axis having 
linear subdivisions. 

To construct above the defined 
plotting area an X-axis having 
linear subdivisions. 

To construct to the left of the 
defined plotting area a Y-axis 
having linear subdivisions. 

To construct to the right of the 
defined plotting area a Y-axis 
having linear subdivisions. 

To construct below the defined 
plotting area an X-axis having 
logarithmic (base 10) subdivisions. 

To construct above the defined 
plotting area an X-axis having 
logarithmic (base 10) subdivisions. 

To construct to the left of the 
defined plotting area a Y-axis 
having logarithmic (base 10) 
subdivisions. 

To construct to the right of the 
defined plotting area a Y-axis 
having logarithmic (base 10) 
subdivisions . 
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Routines to Symbol-Plot Data 

These subroutines plot data according to the coordinate system and construct 
about the plotted point a plot symbol. Plotting specif icatinns of type and 
size of symbol appear in the call list array SPECS. X and Y coordinate 
values are given in the call list arrays X and / (R and Iff ETA for 
PSPOLR). 



Found in 
Section Name 



Call List 



IV-5.4 PSLILI [X,V, SPECS] 



IV-5.6 PSLILG (K,y,SPECS) 



IV-5.8 PSLGLI [X,V, SPECS) 



IV-5.10 PSLGLG (K,Y, SPECS] 



IV-5.12 PSPOLR [ZJHETA, SPECS] 



Function 



To symbol-plot data onto a rectangular 
coordinate system having linear function 
scales for both X and Y ordinates. 

To symbol-plot data onto a rectangular 
coordinate system having a linear 
function scale for the X ordinate 
and a logarithmic (any base) function 
scale for the Y ordinate. 

To symbol-plot data onto a rectangular 
coordinate system having a logarithmic 
(any base) function scale for the X 
ordinate and a linear function scale 
for the Y ordinate. 

To symbol-plot data onto a rectangular 
coordinate system having logarithmic 
(any base) function scales for both 



the X 



Y uidinates. 



To symbol-plot data onto a rectangular 
coordinate system with data given in 
polar coordinates. 
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Routines to Construct a Trend Line through. Data 

Since there is more than one way to pass a trend line through a given set 
of points, several sets of routines fall under this heading. 

Routines to Construct Straight Lines through Data 

These subroutines construct straight lines between consecutive data points. 
No restrictions are imposed on the nature of the input data by the routines. 
Also, any line that intersects the boundaries of the defined plotting area 
is constructed for only that portion of the line lying within or on the 
boundaries. Plotting specifications appear in the call list array SPECS. 
The coordinate values are given in the call list arrays X and / (R and 
THETA for SLPOLR) . 



Found in 
Section 



Name Call List 



Function 



IV-6.2 



SLLILI (X,y,SPECS) 



To construct straight lines between 
consecutive data points on a rectan- 
gular coordinate system having linear 
function scales for both the X and 
Y ordinates . 
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SLLILG (X,y,SPECSl 



To construct straight lines between 
consecutive data points on a rectan- 
gular coordinate system having a 
linear function scale for the X 
ordinate and a logarithmic (any base) 
function scale for the Y ordinate. 



IV-6. 6 



SLLGLI [X,V,SPECS\ 



To construct straight lines between 
consecutive data points on a rectan- 
gular coordinate system having a 
logarithmic (any base) function scale 
for the X ordinate and a linear 
function scale for the Y ordinate. 



IV-6 . 8 



SLLGLG lX,y,SPECSl 



To construct straight lines between 
consecutive data points on a rectan- 
gular coordinate system having log- 
arithmic (any base) function scales 
for both the X and Y ordinates. 



IV-6. 10 SLPOLR IR,THETA,SPECS1 



To construct straight lines between 
consecutive data onto a rectangular 
coordinate system with data given in 
polar coordinates. 
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Routines employing Parabolic Fairing Technique to Construct a Trend Curve 
through Data 

These subroutines construct through the data points a trend curve generated 
by the non-restrictive, general-purpose, parabolic fairing technique.* Hence, 
no restrictions are imposed on the nature of the input data by these routines. 
In addition, should the curve intersect the boundaries of the defined plotting 
area, then only that portion of the curve lying within or on the boundaries 
is constructed. Plotting specifications appear in the call list array SPECS. 
8UFX and BUTY are work regions. The coordinate values are given in the 
call list arrays X and / <R and THETA for PFPOLR) . 



Found in 
Section 



Name 



Call List 



Function 



IV-7.4 



PFLILI 



iX,y,BUFX, 

Bury, specs) 



To construct a trend curve through 
data points on a rectangular coordinate 
system having linear function scales 
for both the X and Y ordinates. 



IV-7.6 PFLILG (X,y,BUFX, 

BUfV,SPECSl 



To construct a trend curve through 
data points on a rectangular coordinate 
system having a linear function scale 
for the X ordinate and a logarithmic 
(any base) function scale for the Y 
ordinate. 



IV-7.8 PFLGLI (X,y,8UFX, 

BUFy, SPECS] 



To construct a trend curve through 
data points on a rectangular coordinate 
system having a logarithmic (any base) 
function scale for the X ordinate 
and a linear function scale for the 
Y ordinate . 



IV-7.10 PFLGLG (X,y,BUFX, 

BUfY, SPECS! 



IV-7.12 PFPOLR (R, THETA, BUFX, 

BUPV,SPECS) 



To construct a trend curve through 
data points on a rectangular coordinate 
system having logarithmic (any base) 
function scales for both the X and 
Y ordinates . 

To construct a trend curve onto a 
rectangular coordinate system with 
data given in polar coordinates. 



See section 4.7 for method used. 
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Routines to Construct Numerical Values along an Axis' Scale 

These subroutines compute and layout a scale of numerical values for an 
ordinate range. Scale layout and number format are specified in the list 
array SPECS. 



Found in 

Section Name Call List 



Function 



IV-8.4 



IV-8.6 



IV-8.8 



IV-8.10 



IV-8.12 



IV-8.14 



IV-8.16 



IV-8.18 



NODLIB (SPECS I 



NODLIT [SPECS] 



NODLIL [SPECS] 



NODLIR [SPECSl 



NOSLIB (SPECS 1 



NOSLIT [SPECS 1 



NOSLIL [SPECS] 



NOSLIR [SPECS] 



To construct below the defined plotting 
area and for a linear X ordinate 
range a numeric scale when the number 
of decimal places is specified. 

To construct above the defined plotting 
area and for a linear X ordinate 
range a numeric scale to the number of 
decimal places specified. 

To construct to the left of the defined 
plotting area and for a linear Y 
ordinate range a numeric scale to the 
number of decimal places specified. 

To construct to the right of the defined 
plotting area and for a linear Y 
ordinate range a numeric scale to the 
number of decimal places specified. 

To construct below the defined plotting 
area and for a linear X ordinate 
range a numeric scale to the number of 
significant figures specified. 

To construct above the defined plotting 
area and for a linear X ordinate 
range a numeric scale to the number of 
significant figures specified. 

To construct to the left of the defined 
plotting area and for a linear Y 
ordinate range a numeric scale to the 
number of significant figures specified. 

To construct to the right of the defined 
plotting area and for a linear Y 
ordinate range a numeric scale to the 
number of significant figures specified. 
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Routines to Construct Numerical Values along an Axis' Scale (continued) 



Found in 

Section Name Call List 



Function 



IV-8.20 NOLGB (SPECS I 



IV-8.22 NOLGT [SPECS] 



IV-8.24 NOLGL [SPECSl 



IV-8.26 NOLGR [SPECSl 



To construct below the defined 
plotting area and for a logarithmic 
(base 10) X ordinate range the 
logarithmic scale. 

To construct above the defined 
plotting area and for a logarithmic 
(base 10) X ordinate range the 
logarithmic scale. 

To construct to the left of the 
defined plotting area and for a 
logarithmic (base 10) Y ordinate 
range the logarithmic scale. 

To construct to the right of the 
defined plotting area and for a 
logarithmic (base 10) Y ordinate 
range the logarithmic scale. 
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Routines to Construct Alphanumeric Titles 

These subroutines layout and construct alphanumeric text to annotate the 
plot. Scale layout, character format and text orientation are specified 
in the call list array SPECS. Separate lines of alhanumeric text are 
given in the several call list arrays (implied by the FORTRAN Hollerith 
Literals). VALUE is a number to be plotted. 



Found in 
Section 



Name Call List 



Function 



IV-9.2 TITLEB (#h...,#h..., 

...,#H...,SPECS1 



To construct consecutive lines of 
alphanumeric text centered below 
and parallel to the bottom side 
of the defined plotting area. 



IV-9.4 TITLET (#h...,*H..., 

...,*H...,SPECS1 



IV-9.6 TITLEL (#H...,*H. .., 

...,#H..., SPECS) 



To construct consecutive lines of 
alphanumeric text centered above 
and parallel to the top side of the 
defined plotting area. 

To construct consecutive lines of 
alphanumeric text centered to the 
left of and parallel to the left 
side of the defined plotting area. 



TITLER [#H...,#R... f 

...,#H..., SPECS) 



To construct consecutive lines of 
alphanumeric text centered to the 
right of and parllel to the right 
side of the defined plotting area. 



IV-9.10 TITLEG (RULE,*H..., 

SPECS) 



To construct a single line of alpha- 
numeric text above an arbitrary 
reference line. 



IV-9.13 SYMKEY (RULE,*H. . . , 

SPECS 1 



To construct a plot symbol together 
with a line of alphanumeric text to 
identify the plot symbol. 



IV-9.16 DECVAL [RULE,l/ALUE, 

SPECS 1 



To construct, when the number of 
decimal places is specified, a numeri- 
cal value along an arbitrary refer- 
ence line. 



IV-9.18 SIGVAL (RULE,l/ALUE, 

I POWER, SPECS 1 



To construct, when the number of 
significant figures is specified, 
a numerical value along an arbitrary 
reference line. 
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Plotter Control Subroutines 

These subroutines control the non-graphic aspects of the plotter (s). 



Found in 

Section Name Call List Function 



IV-10.1 GDSEND (SPECS 1 Terminate plotting. Must be called 

as the last plot subroutine. 

IV-10.2 NXTFRM (SPECS! Initiate a new frame. 
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Routines to Construct Contour Lines through Data 

These routines construct contour lines that represent plane intersections. 
with a surface specified by a number of CX,Y,Z) coordinates. The coordinate 
values are given in the call liat array* X, Y, and Z . The array BUFXVZ 
is a work region. LENGTH is the size of BUfXYl, a variable-sited work 
region. 



Found in 
Section 



Name 



Call List 



CONLI [X,Y,Z,ZLEVEL, 
BUfXVZ, LENGTH, 
SPECS] 



CONBVS (X,Y,Z,ZLEVEL, 
BUTXYZ, LENGTH, 
SPECS I 



Function 



To construct, using only linear 
interpolation, the contour lines 
of one or more contour levels from 
a rectangular grid of values. 

To construct, using a smooth surface 
interpolation technique (bi-variate 
spline), the contour lines of one 
or more contour levels from a 
rectangular grid of values. 



These routines are in a separate volume. 
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Routines to Determine Layout of an Axis ' Scale 

Routine Names 

FABLIX, FABLIY, FAGLIX, FAGLIY 

Purpose 

FABLIX: To determine for an X ordinate range a linear X-scale 
for a blank form. 

FABLIY: To determine for a Y ordinate range a linear Y-scale for 
a blank form. 

FAGLIX: To determine for an X ordinate range a linear X-scale for 
a gridded form. 

FAGLIY: To determine for a Y ordinate range a linear Y-scale for a 

gridded form. 



Method 



The following description applies to either the X or Y axis depending 
on the routine called. 

Blank form : Given the minimum scale range and an upper limit restric- 
tion on the number of scale divisions, the routine extends 
the range and linearly subdivides it in the following way: 

a. The routine divides the given range by the maximum 
number of scale divisions to compute the minimum scale 
step. This value is expressed in scientific notation, 
i.e., A*10 M , where M is an integer. 

b. The routine enlarges the scale step until it becomes 
either 10 N , 2x10", or 5xlO N , where N is an integer. 

c. Then, the routine expands the given scale range such 
that the maximum and minimum values become whole multi- 
ples of either the scale step, or one-half the scale step. 

d. Lastly, the routine divides the expanded scale range by 
the scale step to compute the number of scale subdivisions, 

Gridded form: Given (1) the minimum scale range, (2) the number of 
principal subdivisions of the linearly divided X-axis, 
(3) the length of the axis and (4) its location on the 
gridded form, the routine determines a scale layout in 
the following way: 

a. The routine divides the given range by the given number 
of principal subdivisions to compute the minimum scale 
step. This value is expressed in scientific notation, 
i.e., A*10 M , where M is an integer. 

IV-1.1 



b. The routine enlarges the scale step until it 

becomes either 10^, 2x10", or 5*10", where N is 
an integer. 

c The routine then expands the given scale range such 
that the maximum and minimum values become whole multi- 
ples of either the scale step, or one-half the scale step. 

d. Next, the routine divides the expanded scale range by 
the scale step to compute the required number of scale 
subdivisions . 

e. Finally, the routine compues the length and location 
of the determined scale such that the required length 
of axis lies quasi-centered on the given axis. The 
new length is less than or equal to the given length. 



Restrictions 



Scale Range: Range is limited only by the range of a floating-point 
number (single precision) . 

Usage 

See the following individual subroutine write-ups for: 

A. FORTRAN Call Statement. 

B. Description of call list arguments. 

C. Routines Used. 

D. Example. 
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Subroutine FABLIX 

Purpose 

To determine a linear scale for an X-axis when given a minimum X 
ordinate range and a maximum number of scale subdivisions. 



Usage 



B. 



FORTRAN Call Statement: 

CALL FABLIX {GIVEN , SPECS) 

Description of call list arguments 

GIVEN An array of 3 consecutive floating-point words containing 
raw information. 



Parameter Definitions 

GIVEN [1] Parameter specifies the maximum value of 

the given X ordinate range 

GIVEN [2] Parameter specifies the minimum value of 

the given X ordinate range 

GIVEN (3) Parameter specif ices the upper limit to 
the number of scale subdivisions the 
routine may determine. 

SPECS An array into which the results are stored. Reference 

Table 1 under "The SPECS Array" for definitions and array 
format . In brief , the routine stores the results in the 
words of the array SPECS indicated below by an *. 



Parameter 



Mnemonic 



Parameter 



Mnemonic 



SPECS (J) 

SPECS [2) 

SPECS13) * XRIGHT 

SPECS (4) * XLEFT 

SPECS (5) 



SPECS [6) 
SPECS {7) 
SPECS {8) 
SPECS (9) * . XDIV 



c. 



Note: The maximum and minimum values of the determined scale 
are stored by the routine at SPECS (3) and SPECS ( 4) , 
respectively. 

Routine Used: BSCALE 
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I 



D. Example 



with a maximum value ot 1/.9 and a minimum value of 1.4 for the X 
range and a maximum of 5 subdivisions the setup would be: 

PIMENSI0N GIVEN (31, SPECS [30\ 

GIVENU) = 17.9 

GIVEN(2) - 1.4 

GIVEN(3) - 5. 

CALL FABLIX (GIVEN,SPECS) 

The resulting values in the SPECS array would be: 

SPECS (3) » 20.0 
SPECS (4) - 0.0 
SPECS (9) = 4. 



IV-1 . 5 



Subroutine FABLIY 
Purpose 

To determine a linear scale for a Y-axis when given a mininum Y 
ordinate range and a maximum number of scale subdivisions. 

Usage 

A. FORTRAN Call Statement: 
CALL FABLIY (GI(/EN,SPECS) 

B. Description of call list arguments 

GIVEN An array of 3 consecutive floating-point words containing 

raw information. 

Parameter Definitions 

GIVEN [1) Parameter specifies the maximum value of 

the given Y ordinate range 

GIVEN [2) Parameter specifies the minimum value of 

the given Y ordinate range 

GIVEN {3) Parameter specifies the upper limit to 

the number of scale subdivisions the 
routine may determine. 

SPECS An array into which the results are stored. Reference 

Table 1 under "The SPECS Array" for definitions and array 
format. In brief, the routine stores the results in the 
words of the array SPECS indicated below by an *. 

Parameter Mnemonic Parameter Mnemonic 

SPECS [ 1) SPECS i 6) * YBOT 

SPECS{2) SPECS(7) 

SPECS {3 j SPECS{&) 

SPECS [4) SPECS[9) 

SPECS [5) * YTOP SPECS [10) * YDIV 

Note: The maximum and minimum values of the determined scale 
are stored by the routine at SPECS (5) and SPECS (6), 
respectively. 

C. Routine Used: BSCALE 
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D. Example 



nxm a iuoajjuuiu yaiuc ui iuti,i auu a uixiijaimiu value ui -iii.i iui iuc 

Y range and a maximum of 15 subdivisions the setup would be: 

DIMENSION GIl/EN (31 , SPECS (30 1 

GIl/EN(71 - 7642.2 

GII/EN{2) - -121.7 

GIl/EN(3] - 15. 

CALL FABL IY (GIl/EN, SPECS ) 

The resulting values in the SPECS array would be: 

SPECS(5) - 8000.0 
SPECS (6J - -1000.0 
SPECS (10) - 9. 



IV-1 . 7 



Subroutine FAGLIX 
Purpose 

To determine a linear scale for an X-axis when given a minimum X 
ordinate range and a maximum number of scale subdivisions. 



Usage 



A. 



FORTRAN Call Statement: 

CALL FAGLIX(GIl/EW,SPEC5) 

Description of call list arguments 

Gl l/EN An array of 5 consecutive floating-point words containing 
raw information. 

Parameter Definitions 

GIl/EW ( / ) Parameter specifies the maximum value of 
the given X ordinate range 

GIVEN (2) Parameter specifies the minimum value of 

the given X ordinate range 

GIVEN [3] Parameter specifies the number of principal 

subdivisions of the given linearly divided 
X-axis 

G1VEN[4) Parameter specifies the length (inches) of 

the given X-axis 

GIVEN [5) Parameter specifies the X component of 

the vector distance (inches) from a reference 
point to the left end point of the given 
X-axis 

SPECS An array into which the results are stored. Reference 

Table 1 under "The SPECS Array" for definitions and array 
format. In brief, the routine stores the results in the 
words of the array SPECS indicated below by an *. 



Parameter 



Mnemonic 



Parameter 



.Mnemonic 



SPECS ( 1 ) * XDIST 
SPECS {2) 

SPECS (3) * XRIGHT 
SPECS{4) * XLEFT 
SPECS {5) 



SPECS (6) 

SPECS (7) * XLNGTH 

SPECSit) 

SPECS 9 ) * XDIV 



Note: The maximum and minimum values of the determined scale 
are stored by the routine at SPECS(31 and SPECS (4) , 
respectively. 



C. Routine Used; GSCALE 
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D. Example 



Given a maximum value of 71.6 and a minimum value of 2.2 for the X 
range and a maximum of 5 subdivisions. The approximate length of the 
X-axis wanted is 10 inches. The distance from the reference point to 
the left end point of the given X-axis is approximately 2.0 inches. 
The setup is: 

DIMENSION GIVEN (5), SPECS [30] 

GIVENV) - 71.6 

GIVEN(2) - 2.2 

GIVEN (3 J - 5 

GIVEN (4) - 10.0 

GIVEN (5) - 2.0 

CALL FAGLIX(GIVEN,SPECSj 

The resulting values in the SPECS array would be: 



SPECS! I) - 


2, 


.0 


SPECS (3) - 


80, 


.0 


SPECS {4) = 


0, 


.0 


SPECS (7] = 


8. 


.0 


SPECS (91 - 


4. 


.0 
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Subroutine FAGLIY 



Purpose 



To determine a linear scale for a Y-axis when given a minimum Y 
ordinate range and a linearly divided Y axis. 



Usage 



A. 



B. 



FORTRAN Call Statement: 

CALL FABL I Y(GIl/EN, SPECS) 

Description of call list arguments 

GIVEN An array of 5 consecutive words containing raw information 

Parameter Definition 

GIVEN [1] Parameter specifies the maximum value of 

the given Y ordinate range 

GIVEN (2) Parameter specifies the minimum value of 
the given Y ordinate range 

GIVEN [3) Parameter specifies the number of princi- 

pal subdivisions of the given linearly 
divided Y-axis. 

GJVEN{4) Parameter specifies the length (inches) of 

the given Y-axis 

GIVEN [5) Parameter specifies the Y component of the 

vector distance (inches) from a reference 
point to the bottom end point of the given 
Y-axis. The value is negative if the reference 
point is above the end point; otherwise, the 
value is positive. 

SPECS An array into which the results are stored. Reference 

Table 1 under "The SPECS Array" for definitions and array 
format. In brief, the routine stores the results in the 
words of the array SPECS indicated below by an *. 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS ( I ) 






SPECS {6) * 


YBOT 


SPECS (2) 


* 


YDIST 


SPECS (7) 




SPECS (3) 






SPECS{8) * 


YLNGTH 


SPECS [4) 






SPECS (9) 




SPECS [5) 


* 


YTOP 


SPECS(JO)* 


YDIV 



Note: The maximum and minimum values of the determined scale 
are stored by the routine at SPECS(5) and SPECS(6), 
respectively. 

C. Routine Used: GSCALE 
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D . Example 



Given a maximum value of 12 } 946 and a minimum value of 2 = 369 for the 
Y range and a maximum of 10 subdivisions. The approximate length 
of the Y-axis wanted is 5 inches. The distance from the reference 
point to the bottom end point of the Y-axis is approximately 3.0 
inches. The setup is: 

PIMENSION GI l/EN ( 5 ] , SPECS (30) 

GWEN(1) - 12946.0 

GIVEN (2) - 2.369 

GlVEU(l) = 10.0 

GIVEN [4] = 5.0 

GIVEN (5 i - 3.0 

CALL FAGLIY(GIl/EN,SPECSl 

The resulting values in the SPECS array would be: 



SPECS (2) 


m 


3.5 


SPECS (5) 


=r 


14000.0 


SPECS (6) 


- 


0.0 


SPECS (S\ 


= 


3.5 


SPECS [10] 


EI 


7.0 
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Routines to Construct a Grid 

■ II ■ I !■■■ lipl li lH^lli»ll l l — M^M. 

Routine Names 

GDLILI, GDLILG, GDLGLI, GDLGLG 
Purpose 

GDLILI To construct a grid having linear subdivisions of both axes. 

GDLILG To construct a grid having linear subdivisions of the X-axis 
and logarithmic (base 10) subdivisions of the Y-axis. 

GDLGLI To construct a grid having linear subdivisions of the Y-axis 
and logarithmic (base 10) subdivisions of the X-axis. 

GDLGLG To construct a grid having logarithmic (base 10) subdivisions 
of both axes. 

Method 

These routines construct a set of constant X, i.e., vertical, grid lines 
to depict the X function scale (either linear or logarithmic) and construct 
a set of constant Y, i.e., horizontal, grid lines to depict the Y 
function scale. 

The following description of the linear and logarithmic function grids 
apply to either the X-axis or Y-axis depending on the grid routine called: 

Linear function grids : Equally spaced grid lines are constructed from 

the bottom to top or left to right of the defined 
plotting area depending on grid routine called. 
Grid lines are also constructed on the extremes 
of the plotting area. 

Logarithmic function grids : Grid lines are constructed bottom to top 

or left to right of the defined plotting area 
depending on the grid routine called. The grid 
lines are constructed at the extremes and at each 
cycle and subcycle marks at the values 

N N N N 

10 , 2xl0 W , 3x10 , .... 9*10 

where N is an integer. 

Restrictions 

The size of the grid generated is only limited by the size of the 
allowed plotting area. 
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Usage 

See the following Individual subroutine wrlteups for: 

A. FORTRAN Call Statement 

B. Description of call list arguments 

C. Routines used 

D . Example 
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Subroutine GDLILI 
Purpose 

To construct a rectangular grid having linear subdivisions of both axes. 



Usage 



A. FORTRAN call statement: 
CALL GDLILI (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter Mnemonic 


Parameter 




Mnemonic 


SPECS ( J ) * XDIST 


SPECS {7) 


* 


XLNGTH 


SPECS ( 2 ) * YDIST 


SPECS («) 


* 


YLNGTH 


SPECS [3) 


SPECS (9) 


* 


XDIV 


SPECS (4) 


SPECS (JO) 


* 


YDIV 


SPECS (5) 


SPECS (II) 


* 


TOOL 


SPECS [6) 


SPECS (12) 


* 


CCTAPE 


Routines Used: GDLI, WRGHT, SIGNON 
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D. Example 



DIMENSION SPECS(30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = .87/ 

SPECS(2) = .877 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS (8) =2.5 
C SET XDIV, YDIV 

SPECS(9) = 5. 

SPECS(IO) = 3. 
C SPECIFY TOOL (NORMALLY SET TO ONE} 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C CALL THE LINEAR GRID ROUTINE 

CALL GDLILI (SPECS) 
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00 
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See the appropriate post-processor writeup for the definition 
of the reference point and the dimensions of the plotting area. 
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Subroutine GDLILG 



Purpose 



To construct a rectangular grid having linear subdivisions of the 
X-axis and logarithmic (Base 10) subdivisions of the Y-axis. 



Usa^e 



A. FORTRAN call statement 
CALL GDLILG (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 

SPECS [1) 
SPECS [2) 
SPECS (3) 
SPECS (4) 
SPECS (5) 
SPECS (61 



* 






Mnemonic 

XDIST 
YDIST 



YTOP 
YBOT 



Parameter 


* 


Mnemonic 


SPECS (7) 


XLNGTH 


SPECS (8) 


* 


YLNGTH 


SPECS (9) 


* 


XDIV 


SPECS (10) 






SPECS(H) 


* 


TOOL 


SPECS (12) 


* 


CCTAPE 



C. Routines Used: GDLI, GDLG, WRGHT, SIGNON 
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Example 



DIMENSION SPECS(30) 

C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = .877 

SPECS(2) = .877 
C SET YTOP, YBOT 

SPECS(5) - 1.0 

SPECS (6) =0.1 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SET XDIV 

SPECS(9) = 3. 
C SPECIFY TOOL '(NORMALLY SET TO ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C CALL THE LINEAR, LOG GRID ROUTINE 

CALL GDLILG (SPECS) 
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See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 



IV-2.7 



Subroutine GDLGLI 



Purpose 



To construct a rectangular grid having logarithmic (base 10) sub- 
divisions of the X-axis and linear subdivisions of the Y-axis. 



Usage 



A. FORTRAN call statement 
CALL GDLGLI (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 




Mnemonic 


SPECS(l) * 


XDIST 


SPECS (7) 


* 


XLNGTH 


SPECS [2) * 


YDIST 


SPECS [t) 


* 


YLNGTH 


SPECS (3) * 


XRIGHT 


SPECS (9) 






SPECS (4) * 


XLEFT 


SPECS [ 10) 


* 


YDIV 


SPECS (5) 




SPECS [11) 


* 


TOOL 


SPECS [6) 




SPECS { 12) 


*. 


CCTAFE 


Routine Used: GDLI, 


GDLG, WRGHT, 


SIGNON 
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D . Example 



DIMENSION SPECS(30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = .877 

SPECS (2) = .877 
C SET XRIGHT, XLEFT 

SPECS(3) = 1.0 

SPECS(4) = 80.0 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SET YDIV 

SPECS(IO) = 3. 
C SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C CALL LOG LINEAR GRID 

CALL GDLGLI (SPECS) 
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See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine GDLGLG 



Purpose 



To construct a rectangular grid having logarithmic (base 10) sub- 
divisions of both axes. 



Usage 



A. FORTRAN call statement 
CALL GDLGLG [SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS (1) 


* 


XDIST 


SPECS {7) * 


XLNGTH 


SPECS (2) 


* 


YDIST 


SPECS {8 J * 


YLNGTH 


SPECS (3) 


* 


XRIGHT 


SPECS [9) 




SPECS {4) 


* 


XLEFT 


SPECS (J0) 




SPECS (5) 


* 


YTOP 


SPECS! I 1) * 


TOOL 


SPECS (6) 


* 


YBOT 


SPECS(J2) * 


CCTAPE 



Routines Used: GDLG, WRGHT, SIGNON 
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Example 



C 

C 

C 

C 

C 
C 
C 



DIMENSION SPECS(30) 

SET XDIST, YDIST (IN INCHES) 

SPECS (1) = =877 

SPECS(2) = .877 

SET XRIGHT, XLEFT 

SPECS(3) = 100.0 

SPECS(4) = 1.0 

SET YTOP, YBOT 

SPECS(5) = 73.0 

SPECS(6) = 10.0 

SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8^ = 2.5 

specify'tool'(normally SET TO ONE) 

SPECS(11 ) = 1 . 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 

CALL THE LOG, LOG GRID ROUTINE 

CALL GDLGLG (SPECS) 
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Reference 
Point 

See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Routines to Construct a Pair of Coordinate Axes 



Routine Names 

AXLILI, AXLILG, AXLGLI, AXLGLG 

Purpose 

AXLILI To construct a pair of linear function scales for both axes. 

AXLILG To construct a linear function scale for the X-axis and a 
logarithmic (base 10) function scale for the Y-axis . 

AXLGLI To construct a linear function scale for the Y-axis and a 
logarithmic (base 10) function scale for the X-axis. 

AXLGLG To construct a pair of logarithmic (base 10) function scales 
for both axes. 

Method 

These routines construct a pair of axes along the bottom and the left 
side of the defined plotting area. 

The following description of the linear and logarithmic function scales 
apply to either the X-axis or Y-axis depending on the axis routine called. 

Linear function scales ; equally spaced scale marks (0.05 inches long) 

are constructed from the appropriate axis 
projecting into the plotting area. Scale 
marks are also drawn on the axis extremes. 

Logarithmic function scales : scale marks (0.05 inches long) are 

constructed at each extreme of the axis 
and within each cycle within the range at 
the values 

10 n , 2xl0 n , ..., 9xl0 n , 
where n is an integer. 

Restrictions 

The size of the axes generated are only limited by the size of the 
plotting area. 

Usage 

See the following individual subroutine write-ups for: 

A. FORTRAN call statement 

B. Description of call list arguments 

C. Routines Used 

D. Example 

IV-3.1 



Subroutine AXLILI 



Purpose 

To construct a pair of axes for a rectangular coordinate system having 
linear function scales for both axes. 



Usage 



A. FORTRAN call statement 
CALL AXLILI {SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 

SPECS! 1) 
SPECS (2) 
SPECS (3) 
SPECS (4 J 
SPECS (5) 
SPECS [6] 



* 

* 



Mnemonic 

XDIST 
YDIST 



Parameter 



Mnemonic 



SPECS (7) 


* 


XLNGTH 


SPECS (S) 


* 


YLNGTH 


SPECS (9) 


* 


XDIV 


SPECS {10) 


* 


YDIV 


SPECS[11) 


* 


TOOL 


SPECS(/2) 


* 


CCTAPE 



Routines Used: AXLI, WRGHT, SIGNON 
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Example 



C 

c 

c 

c 
c 
c 



DIMENSION SPECS(3Q) 

SET XDIST, YDIST (IN INCHES] 

bPtCS(l) = .8/7 

SPECS(2) = 877 

SET XLNGTH,'YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 

SET XDIV, YDIV* 

SPECS(9) = 10. 

SPECS(IO) = 5. 

SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(ll) = 1. 

SPECIFY INTbRMEUlAlt ULt NUMBER 

SPECS(12) = 99. 

CALL LINEAR, LINEAR AXIS ROUTINE 

CALL AXLILI (SPECS) 



These may also be determined as a result of FABLIX, FABLIY. 




Reference *" 
Point 

See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine AXLILG 
Purpose 

To construct a pair of axes for a rectangular coordinate system having 
a linear function scale for the X-axis and a logarithmic (base 10) 
function scale for the Y-axis. 



Usage 



A. FORTRAN call statement 
CALL AXLILG (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 




Mnemonic 


SPECS ( J ) 


* XDIST 




SPECS (7) 


* 


XLNGTH 


SPECS [2) 


* YDIST 




SPECS [8) 


* 


YLNGTH 


SPECS [3) 






SPECS (9) 


* 


XDIV 


SPECS (4) 






SPECS (10) 






SPECS (5) 


* YTOP 




SPECS(11) 


* 


TOOL 


SPECS (6) 


* YBOT 




SPECS (12) 


* 


CCTAPE 


Routines Used: 


AXLI, AXLG, 


WRGHT, 


SIGNON 
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Example 



C 
C 
C 

c 
c 
c 
c 



DIMENSION SPECS(30) 

SET XDIST, YDIST (IN INCHES) 

;>rt.u>vi/ = •<>// 

SPECS(2) = .877 

SET YTOP, YBOT 

SPECS(5) = 1000.0 

SPECS(6) = 1.0 

SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 

SET XDIV 

SPECS(9) = 2. 

SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(ll) =1. 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 

CALL LINEAR, LOG AXIS ROUTINE 

CALL AXLILG (SPECS) 
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See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine AXLGLI 
Purpose 

To construct a pair of axes for a rectangular coordinate system having 
a logarithmic (base 10) function scale for the X-axis and a linear 
function scale for the Y-axis. 



Usage 
A. 



FORTRAN call statement 
CALL AXLGLI {SPECS) 



B. Description of call list arguments 



SPECS 



An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 
* XDIST 


Parameter 
SPECS (7) 


* 


Mnemonic 


SPECS ( I ) 


XLNGTH 


SPECS (2) 


* YDIST 


SPECS m 


* 


YLNGTH 


SPECS (3 J 


* XRIGHT 


SPECS (9) 






SPECS (4) 


* XLEFT 


SPECS (/OJ 


* 


YDIV 


SPECS (51 




SPECSU1) 


* 


TOOL 


SPECS [6) 




SPECS(JZ) 


* 


CCTAPE 



Routines Used: AXLI, AXLG, WRGHT, SIGNON 
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D. Example 



C 

c 
c 
c 



DIMENSION SPECS(30) 

SET XDIST, YDIST (IN INCHES) 



eorrcM \ 



Q77 



SPECS(2) = .877 

SET XRIGHT, XLEFT 

SPECS(3) = 15.0 

SPECS(4) = 7.5 

SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 

SET YDIV 

SPECS(IO) = 3. 

SPECIFY TOOL (NORMALLY 

SPECS(11 ) - 1 . 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 

CALL LOG, LINEAR AXIS ROUTINE 

CALL AXLGLI (SPECS) 



SET TO ONE) 
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en 



oo 




YDIV 
(10) 



XLNGTH 



Point 



(7) 



See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine AXLGLG 



Purpose 



To construct a pair of axes for a rectangualr coordinate system 
having logarithmic (base 10) function scales for both axes. 



Usage 



A. FORTRAN call statement 
CALL AXLGLG (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


* 


Mnemonic 
XDIST 


Parameter 
SPECS (7) 


* 


Mnemonic 


SPECS {1) 


XLNGTH 


SPECS (2) 


* 


YDIST 


SPECS {8) 


* 


YLNGTH 


SPECS (3) 


* 


XRIGHT 


SPECS (9 J 






SPECS (4) 


* 


XLEFT 


SPECS (JO) 






SPECS (5) 


* 


YTOP 


SPECS111) 


* 


TOOL 


SPECS (6\ 


* 


YBOT 


SPECSU2) 


* 


CCTAPE 



C. Routines Used: AXLG, WRGHT, SIGNON 
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Example 



DIMENSION SPECS(30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = .877 

SPECS(2) = .877 
C SET XRI6HT, XLEFT 

SPECS(3) = 0.1 

SPECS(4) = 100.0 
C SET YTOP, YBOT 

SPECS(5) = 13.0 

SPECS(6) = 3.0 
C SET XLNGTH, YLGNTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(11 ) = 1 . 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C CALL LOG, LOG AXIS ROUTINE 

CALL AXLGLG (SPECS) 
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See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Routines to Construct a Supplementary Axis 

Routine Names 

SAXLIB, SAXLIT, SAXLIL, SAXLIR, SAXLGB, SAXLGT, SAXLGL, SAXLGR 

Purpose 

To construct a supplementary axis either above, below, to the left, 
or to the right of the defined plotting area depending on the suffix 
letter (B,T,L,R) of the subroutine called. The supplementary axis 
can be constructed with either linear or logarithmic subdivisions 
(denoted by LI or LG in the subroutine name). 

Method 

The routines construct a supplementary axis either above, below, to 
the left or to the right of the defined plotting area. This axis 
is offset from the defined plotting area by 0.15 inches plus the 
value of the appropriate ZONE value. To denote the subdivisions, 
scale marks 0.05 inches in length are constructed from the supplementary 
axis toward the plotting area. After the construction, the routines 
automatically add 0.15 to the appropriate ZONE value. 

Restrictions 

None 
Usage 

See the following individual subroutine writeups for: 

A. FORTRAN Call Statements 

B. Description of call list arguments 

C. Routines Used 

D. Example 
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Subroutine SAXLIB 



Purpose 



To construct below the defined plotting area an X-axis having linear 
subdivisions. 



Usage 



A. FORTRAN Call Statement: 
CALL SAXLIB {SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 
XDIST 


Parameter 
SPECS {J 3) 


Mnemonic 


SPECS!?) * 




SPECSiZ) * 


YDIST 


SPECS(U) 




SPECS (3) 




SPECS [ 15) 




SPECS [4] 




SPECSiU) 




SPECS (5) 




SPECS[17) 




SPtCS[6) 




SftCSi'lS) 




SPECS (7) * 


XLNGTH 


SPECS [J 9) 




SPECS [S] 




SPECS (20) 




SPECS (9) * 


XDIV 


spEcsan 




SPECS (70) 




SPECS! 22) 




SPECS! MJ* 


TOOL 


SPECS (23) 




SPECSU2)* 


CCTAPE 


SPECS (24) * 


ZONEB 



C. Routines Used: AXLI, WRGHT, SIGNON 
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D. Example 



DIMENSION SPECS(30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = .877 

SPECS(2) = .877 
C SET XLNGTH (IN INCHES) 

SPECS(7) = 2.5 
C SET XDIV 

SPECS(9) = 8. 
C SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS (12) = 99. 
C SET ZONEB 

SPECS(24) = 0.0 
C CALL BOTTOM SUPPLEMENTARY AXIS ROUTINE 

CALL SAXLIB (SPECS) 



NOTE: ZONEB is incremented after the construction so that the next 
construction below the defined plotting area will not overlap, 



XLNGTH 



Reference 
Point 




ZONEB Before 

Construction 

ZONEB After 

Construction 



See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine SAXLIT 



Purpose 



To construct above the defined plotting area an X-axis having 
linear subdivisions. 



Usage 



A. FORTRAN Call Statement: 
CALL SAXLIT {SPECS) 

B. Description of call list arguments: 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


* 


Mnemonic 
XDIST 


Parameter 
SPECS [14] 


Mnemonic 


SPECS (1) 




SPECS (2) 


* 


YDIST 


SPECS [15) 




SPECS (3) 






SPECS [16) 




SPECS [4) 






SPECS[17) 




SPECS (5) 






' SPECS [18 J 




SPECS (6) 






SPECS[ 79) 




SPECS (7) 


* 


XLNGTH 


SPECS (20) 




SPECS (S) 


* 


YLNGTH 


SPECS (27) 




SPECS (9) 


* 


XDIV 


SPECS (22) 




SPECS [10) 






SPECS (23) 




SPECS [11) 


* 


TOOL 


SPECS [24) 




SPECS [12) 


* 


CCTAPE 


SPECS (25) * 


! ZONET 


SPECS [13) 










is Used: AXLI, 


, WRGHT, SIG1 


TON 
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D. 



Example 



DIMENSION SPECS(30) 
r SET XDIST. YDIST (IN INCHES) 

SPECS (i) = .877 

SPECS(2) = .877 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SET XDIV 

SPECS(9) = 4. 
C SPECIFY TOOL* (NORMALLY SET TO ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SET ZONET 

SPECS(25) = 0.1 
C CALL TOP SUPPLEMENTARY AXIS ROUTINE 

CALL SAXLIT (SPECS) 



NOTE: ZONET is incremented after the construction so that the next 
construction above the defined plotting area will not overlap. 
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(1) 

See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SAXLIL 



Purpose 



To construct to the left of the defined plotting area a Y-axis 
having linear subdivisions. 



Usage 



A. FORTRAN Call Statement: 

CALL SAXLIL (SPECS) 

6. Description of call list arguments: 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 


Mnemonic 


SPECS (J) * 


XDIST 


SPECS [14) 




SPECS (2) * 


YDIST 


SPECS [15) 




SPECS (3) 




SPECS [16) 




SPECS [4) 




SPECS!/ 7) 




SPECS (5) 




SPECS[1S) 




SPECS [6) 




SPECS [1 9) 




SPECS [7 ) 




SPECS (20) 




SPECS [&) * 


YLNGTH 


SPECS[21) 




SPECSI9J 




SPECS [22) 




SPECSilO)* 


YDIV 


SPECS (23) 




SPECS(Jl)* 


TOOL 


SPECS [24) 




SPECS[12)* 


CCTAPE 


SPECS (25) 




SPECS [13) 




SPECS (26) < 


* ZONEL 



Routines Used: AXLI, WRGHT, S1GNON 
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Example 



C 

C 



DIMENSION SPECS(30) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 

SET XLNGTH, YLNGTH (IN INCHES] 

SPECS(7) = 2.5 

SPECS(8) = 2.5 

SET YDIV 

SPECSflO) =/6. 

SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(ll) = 1. 

oFtoin IN i cRMtuiAi t riLt nuMBEk 

SPECS(12) = 99. 

SET ZONEL (IN INCHES) 

SPECS(26) = 0.15 

CALL LEFT SUPPLEMENTARY AXIS ROUTINE 

CALL SAXLIT (SPECS) 



■ 



NOTE: ZONEL is incremented after the construction so that the next 

construction to the left of the defined plotting area will not 
overlap. 



ZONEL After Construction 
ZONEL Before Construction 




Reference *"•" 
Point 

See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SAXLIR 



Purpose 



To construct to the right of the defined plotting area a Y-axis 
having linear subdivisions. 



Usage 



A. FORTRAN call statement: 
CALL SAXLIR (SPECS) 

B. Description of call list arguments: 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS (1) 


* 


XDIST 


SPECS (15) 




SPECS (2) 


* 


YDIST 


SPECSl U) 




SPECS {3) 






SPECSIJ7) 




SPECS (4) 






SPECSi /«) 




SPECS (5) 






SPECSl J9) 




SPECS (6) 






SPECS [20] 




SPECS (7) 


* 


XLNGTH 


SPECS [21] 




SPECS [i] 


* 


YLNGTH 


SPECS (22) 




SPECS (9) 






SPECS (23) 




SPECS [10) 


* 


YDIV 


SPECS (24) 




SPECS [11) 


* 


TOOL 


SPECS (25) 




SPECS [12) 


* 


CCTAPE 


SPECS(26) 




SPECS [1 3) 






SPECS (27) « 


* ZONER 


SPECS[14) 











C. Routines Used: AXLI, WRGHT, SIGNON 
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D. Example 



DIMENSION SPECS(30) 
C SET XDIST, YDIST fIN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) » 2.5 
C SET YDIV 

SPECS(IO) = 6. 
C SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(ll) =1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SET ZONER 

SPECS(27) = 0.15 
C CALL RIGHT SUPPLEMENTARY AXIS ROUTINE 

CALL SAXLIR (SPECS) 



NOTE; ZONER is incremented after the construction so that the next 
construction to the right of the defined plotting area will 
not overlap. 



ZONER After Construction 
ZONER Before Construction- 



Reference '- ^if 
Point u; 




O —i 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SAXLGB 



Purpose 



To construct below the defined plotting area an X-axis having 
logarithmic (base 10) subdivisions. 



Usage 



A. FORTRAN call statement: 
CALL SAXLGB {SPECS) 

B. Description of call list arguments: 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS (J) 


* 


XDIST 


SPECS! 13) 




-SPECS (2) 


* 


YDIST 


SPECS (14) 




SPECS (3) 


* 


XRIGHT 


SPECS (75) 




SPECS {4) 


* 


XLEFT 


SPECS (J6) 




SPECS (5) 






SPECSU7) 




SPECS ( 6) 






SPECSUS) 




SPECS (7) 


* 


XLNGTH 


SPECS! 19) 




SPECS [&) 






SPECS (20) 




SPECS (9) 






SPECS 121) 




SPECS (JO) 






SPECS (22) 




SPECS{ 11) 


* 


TOOL 


SPECS (23) 




SPECS (12) 


* 


CCTAPE 


SPECS (24) * 


ZONEB 


les Used: . 


hXLQ 


1, WRGHT, 


SIGNON 
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Example 

DIMENSION SPECS(30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XRIGHT, XLEFT 

SPECS(3) = 12.5 

SPECS(4) = 0.8 
C SET XLNGTH (IN INCHES) 

SPECS(7) = 2.5 
C SPECIFY TOOL '(NORMALLY SET TO ONE) 

SPECS(ll) = 1, 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SET ZONEB 

SPECS(24) = 0.2 
C CALL BOTTOM LOG SUPPLEMENTARY AXIS ROUTINE 

CALL SAXLGB (SPECS) 



NOTE; ZONEB is incremented after the construction so that the next 

construction below the defined plotting area will not overlap. 



Reference 
Point 




XDIST x 

"TTT 



I — ZONEB Before 
*«J Construction 



L ZONEB After 

Construction 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SAXLGT 



Purpose 



To construct above the defined plotting area an X-axia having 
logarithmic (base 10) subdivisions. 



Usage 



A. FORTRAN call statement: 
CALL SAXLGT {SPECS) 

B. Description of call list arguments: 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 

Mnemonic 



Parameter 




Mnemonic 


Parameter 


SPECS (?) 


* 


XDIST 


SPECS[14) 


SPECS (2) 


* 


YDIST 


SPECS! 15) 


SPECS (3) 


* 


XRIGHT 


SPECS[16) 


SPECS [4 ) 


* 


XLEFT 


SPECS! 17) 


SPECS (5! 






SPECS [1 8) 


SPECS(6) 






SPECSU9) 


SPECS (7) 


* 


XLNGTH 


SPECS (20) 


SPECS [S) 


* 


YLNGTH 


SPECS{21) 


SPECS (9) 






SPECS (22) 


SPECS [10) 






SPECS (23) 


SPECS [11) 


* 


TOOL 


SPECS (24) 


SPECS [12) 


* 


CCTAPE 


SPECS (25) 


SPECS[13) 








Routines Used: i 


\XLG 


, WRGHT, SIGNOK 


1 



ZONET 
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D. Example 

DIMENSION SPECS (30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = 0.8777 

SPECS(2) = 0.8777 
C SET XRIGHT, XLEFT 

SPECS(3) = 1.0 

SPECS(4) = 15.0 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFY TOOL '(NORMALLY SET TO ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SET ZONET 

SPECS(25) = 0.15 
C CALL TOP LOG SUPPLEMENTARY AXIS ROUTINE 

CALL SAXLGT (SPECS) 



NOTE: ZONET is incremented after the construction so that the next 

construction above the defined plotting area will not overlap. 



i i i 



'£ ZONET After 

J f~™ Construction 



>- 



LT) 



Q 

>- 



Reference *"• 



00 



PRCVIOUS CO NSTWUCTIOW "^\_ Z0 NET Before 

Construction 



XDIST 



Point 



(1) 



XLNGTH 



(7) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SAXLGL 



Purpose 



To construct to the left of the defined plotting area a Y-axis 
having logarithmic (base 10) subdivisions. 



Usage 



A. FORTRAN call statement: 
CALL SAXLGL (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS (J) 


* 


XDIST 


SPECS[14) 




SPECS (2) 


* 


YDIST 


SPECS [15) 




SPECS [3) 






SPECS [16) 




SPECS [4) 






SPECS [17) 




SPECS [5) 


* 


YTOP 


SPECS!?*) 




SPECS [6) 


* 


YBOT 


SPECS [1 9) 




SPECS (7) 






SPECS [20) 




SPECS (S) 


* 


YLNGTH 


SPECS [21 ) 




SPECS (9) 






SPECS (22) 




SPECS (TO) 






SPECS (23) 




SPECS [11) 


* 


TOOL 


SPECS [24) 




SPECS [ 12) 


* 


CCTAPE 


SPECS [25) 




SPECS(J3) 






SPECS [26) i 


* ZONEL 


Routines Used: AXLG 


, WRGHT, SIGNOK 


f 
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D. Example 



DIMENSION SPECS (30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET YTOP, YBOT 

SPECS(5) = 7.0 

SPECS(6) = 15.0 
C SET LNGTH (IN INCHES) 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(ll) * 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. ~ 
C SET ZONEL 

SPECS(26) = 0.0 
C CALL LEFT LOG SUPPLEMENTARY AXIS ROUTINE 

CALL SAXLGL (SPECS) 



NOTE; ZONEL is incremented after the construction so that the next 

construction to the left of the defined plotting area will not 
overlap . 



ZONEL After Construction 
ZONEL Before Construction 



Reference 
Point 




t XDIST 
ID 

See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 



IV-4.15 



Subroutine SAXLGR 



Purpose 



To construct to the right of the defined plotting area a Y-axis 
having logarithmic (base 10) subdivisions. 



Usage 



A. FORTRAN call statement: 
CALL SAXLGR {SPECS) 

B. Description of call list arguments: 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS! /) 


* 


XDIST 


SPECS (J 5) 




SPECS (2) 


* 


YDIST 


SPECSU6) 




SPECS {3) 






SPECS [17) 




SPECS [4) 






SPECSH8) 




SPECS (5) 


* 


YTOP 


SPECS (19) 




SPECS (6) 


* 


YBOT 


SPECS (20) 




SPECS (7) 


* 


XLNGTH 


SPECS(2J) 




SPECS ($) 


* 


YLNGTH 


SPECS (22) 




SPECS (9) 






SPECS (23) 




SPECSi 10) 






SPECS (24) 




SPECS! M) 


* 


TOOL 


SPECS (25) 




SPECS (12) 


* 


CCTAPE 


SPECS (26) 




SPECS (13) 






SPECS (27) 




SPECS (14) 






SPECS (28) * 


ZONER 


as Used: , 


\XLG, WRGHT, 


SIGNON 
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D. Example 

DIMENSION SPECS(30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET YTOP, YBOT 

SPECS(5) = 0.1 

SPECS(6) = 100.0 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(11 ) = 1 . 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SET ZONER 

SPECS(27) = 0.25 
C CALL RIGHT LOG SUPPLEMENTARY AXIS ROUTINE 

CALL SAXLGR (SPECS) 



NOTE: ZONER is incremented after the construction so that the next 
construction to the right of the defined plotting area will 
not overlap. 



ZONER After Construction 
ZONER Before Construction 



Reference 
Point 




See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Routine Names 



PSLILI, PSLILG, PSLGLI, PSLGLG, PSPOLR 



Purpose 

PSLILI 

PSLILG 
PSLGLI 
PSLGLG 



PSPOLR 



To symbol-plot data onto a rectangular coordinate system 
having linear function scales for both X and Y ordinates, 

To symbol-plot data onto a rectangular coordinate system 
having a linear function scale for the X ordinate and a 
logarithmic (any base) function scale for the Y ordinate. 

To symbol-plot data onto a rectangular coordinate system 
having a logarithmic (any base) function scale for the X 
ordinate and a linear function scale for the Y ordinate. 

To symbol-plot data onto a rectangular coordinate system 
having logarithmic (any base) function scales for both the 
X and Y ordinates. 

To symbol-plot data given in polar coordinates onto a rec- 
tangular coordinate system. 



Method 



Each data point is examined. If the point lies outside the range of 
either scale, the point is not plotted, nor is the plot symbol con- 
structed. If the point lies within the range, of both scales, the point 
is plotted and the plot symbol is constructed about the point. 

Data points are defined as follows: 

The first point is defined by the coordinate pair [X(1),Y(1)]; 
the next sequential point is [X(1+XSKIPS) , Y(1+YSKIPS) ] |, which is 
followed by [X(1+2*XSKIPS) , (Y(1+2*YSKIPS) ] , etc. POINTS — 
SPECS [13) — is the total number of X,Y coordinate pairs to be 
considered. 



Restrictions 



A. Point count: One point minumum 

B. Data range: For linear function scales, the range is limited only 

by the range of a floating-point number (single pre- 
cision) . For logarithmic function scales, the range 
must contain floating-point numbers (single precision) 
which are all positive, or all negative, and non-zero. 
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Usage 

See the following individual subroutine write-ups for: 

A. FORTRAN call statement 

B. Description of call list arguments 

C. Routines Used 

D . Example 
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Subroutine PSLILI 



Purpose 



To symbol-plot a set of numerical values (X ordinates) against 
another set (Y ordinates) in a rectangular coordinate system having 
linear functions scales for both axes. 



Usage 



A. FORTRAN call statement 
CALL PSLILI (X,y,SPECS) 

B. Description of call list arguments 

X An array containing the X ordinates of data points to 
be processed. Values are floating-point. 

V An array containing the Y ordinates of data points to 

be processed. Values are floating-point. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters "indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS(l) 


* 


XDIST 


SPECS (10) 






SPECS (2) 


* 


YDIST 


SPECS!//) 


* 


TOOL 


SPECS (3) 


* 


XRIGHT 


SPECS(12) 


* 


CCTAPE 


SPECS (4) 


* 


XLEFT 


SPECS (13) 


* 


POINTS 


SPECS (5) 


* 


YTOP 


SPECS (14) 


* 


XSKIPS 


SPECS [6] 


* 


YBOT 


SPECS (15) 


* 


YSKIPS 


SPECS (7) 


* 


XLNGTH 


SPECS! 16) 


* 


SYMBOL 


SPECS (8) 


* 


YLNGTH 


SPECS ( 17) 


* 


FONTB 


SPECS [9] 






SPECS! /«) 


* 


FONTH 



The first point is defined by the coordinate pair [X(l) , Y(l)]; 
The next sequential point is [X(1+XSKIPS) , Y(1+YSKIPS) ] , which 
is followed by IX(1+2XSKIPS) , Y(1+2YSKIPS)] , etc. 

Routines Used: WRGHT, SIGNON 



IV-5.4 



D. Example 



DIMENSION SPECS(30), X(10), Y(10) 
C SET XDIST, YDIST (IN INCHES) 

bPECS(l) = .87/ 

SPECS(2) = .877 
C SET XRIGHT, XLEFT 

SPECS(3) = 10.0 

SPECS(4) = 1.0 
C SET YTOP, YBOT 

SPECS(5) = 10.0 

SPECS(6) = 1.0 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SPECIFY NUMBER OF POINTS 

SPECS(13) = 10. 
C SET XSKIPS, YSKIPS 

SPECS(14) = 1. 

SPECS(15) = 1. 
C SPECIFY SYMBOL NUMBER 

SPECS(16) = 1. 



C SET FONTB, 


FONTH 


(IN I 


SPECS(17) = 


0.1 




SPECS(18) = 


0.1 




C SETUP 


X, Y 


DATA ARRAYS 


X(D ■ 


0.1 






Y(l) = 


0.1 






X(2) = 


0.5 






Y(2) = 


0.2 






X(3) = 


1.2 






Y(3) = 


0.7 






X(4) = 


1.6 






Y(4) = 


1.7 






X(5) = 


2.5 






Y(5) = 


3.0 






X(6) = 


3.5 






Y(6) = 


4.2 






X(7) = 


5.3 






Y(7) = 


7.2 






X(8) = 


8.1 






Y(8) = 


6.2 






X(9) = 


9.2 






Y(9) = 


7.3 






X(10) 


= 10.. 


5 





INCHES) 



Y(10) = 10.5 

CALL SYMBOL PLOT ROUTINE 

CALL PSLILI (X.Y.SPECS) 



Reference 
Point 




YBOT 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine PSLILG 



Purpose 



To symbol-plot a set of numerical values (X ordlnates) against another 
set (Y ordlnates) in a rectangular coordinate system having a linear 
function scale for the X-axis and a logarithmic function scale for 
the Y-axis. 



Usage 



FORTRAN call statement 

CALL PSLILG [X,V, SPECS) 

Description of call list arguments 

X An array containing the X ordlnates of data points to 
be processed. Values are floating-point. 

V An array containing the Y ordlnates of data points to 

be processed. Values are floating-point. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


* 


Mnemonic 
XDIST 


Parameter 
SPECS (16) 


Mnemonic 


SPECS {1) 


* SYMBOL 


SPECS (2) 


* 


YDIST 


SPECS (17) 


* FONTB 


SPECS (3) 


* 


XR1GHT 


SPECS (18) 


* FONTH 


SPECS (4) 


* 


XLEFT 


SPECS (19) 




SPECS (5) 


* 


YBOT 


SPECS (20) 




SPECS (6) 


* 


YTOP 


SPECS{21) 




SPECS (7) 


* 


XLNGTH 


SPECS (22) 




SPECS (8) 


* 


YLNGTH 


SPECS (23) 




SPECS (9) 






SPECS (24) 




SPECS (10) 






SPECS (25) 




SPECS [11) 


* 


TOOL 


SPECS (26) 




SPECS [12) 


* 


CCTAPE 


SPECS (27) 




SPECS! J 3) 


* 


POINTS 


SPECS (2 8) 




SPECS [14) 


* 


XSKIPS 


SPECS (29) 




SPECS (15) 


* 


YSKIPS 


SPECS (30) 


* STAPE 



The first point is defined by the coordinate pair [X(l) , Y(l)]; 
the next sequential point is [X(1+XSKIPS) , Y(1+YSKIPS) ] , which 
is followed by [X(1+2XSKIPS) , Y(1+2YSKIPS) ] , etc. 

Routines Used: NONLIN, PSLILI, WRGHT, SIGNON 
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Example 





DIMENSION SPECS(30), X(10), Y(10) 


C 


SET XSKIPS, YSKIPS 


c 


SET XDIST, YIST (IN INCHES) 




SPECS(14) = 1. 




SPECS(l) = 0,877 




SPECSM5) = 1. 




SPECSC2) = 0.877 


C 


SPECIFY SYMBOL NUMBER 


c 


SET XRIGHT, XLEFT 




SPECS(16) = 2. 




SPECS(3) = 10.0 


C 


SET FONTB.FONTH (INCHES) 




SPECS(4) = 1.0 




SPECS(17) = 0.1 


c 


SET YTOP, YBOT 




SPECS(18) = 0.1 




SPECS(5) = 10.0 


C 


SPECIFY SCRATCH FILE NUMBER 




SPECS(6) =1.0 




SPECS(30) = 97. 


c 


SET XLNGTH, YLNGTH (IN INCHES) 


C 


SETUP SAMPLE X,Y ARRAYS 




SPECS(7) = 2.5 




DO 10 I = 1,10 




SPECS (R^ = ?.R 




ym = t 

'* \ * / ■* 


c 


SPECIFY" TOOL (NORMALLY ONE) 




Y(D = I 




SPECS(ll) = 1. 


10 


CONTINUE 


c 


SPECIFY INTERMEDIATE FILE NUMBER 


C 


CALL SYMBOL PLOT ROUTINE 




SPECS02) = 99. 


C 


LINEAR X, LOG Y 


c 


SPECIFY NUMBER OF POINTS 




CALL PSLILG (X,Y, SPECS) 




SPECS(13) = 10. 




* 
■ 






t— i in 
x 



e 



00 



V 






Reference *« X (| ) T " 



CM 



XLNGTH 



( 



w 



YTOP 
(5) 



YBOT 
(6) 



Point 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine PSLGLI 

Purpose 

To symbol-plot a set of numerical values (X ordinates) against another 
set (Y ordinates) in a rectangular coordinate system having a loga- 
rithmic function scale for the X-axis, and a linear function scale 
for the Y-axis. 



Usage 



A. FORTRAN call statement 
CALL PSLGLI (X,/, SPECS) 

B, Description of call list arguments 

X An array containing the X ordinates of data points to 

be processed. Values are floating-point. All X values 
must be all positive, or all negative, and all non-zero. 

V An array containing the Y ordinates of data points to 

be processed. Values are floating-point. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 

format. inis routine requires me -j> uw i-owius^.- xuuo. 

below by the * to be specified prior to calling it: 



Parameter 

SPECS in 


* 


Mnemonic 
XDIST 


Parameter 
SPECS (16) * 


Mnemonic 
SYMBOL 


SPECS (2) 


* 


YDIST 


SPECSU7) * 


FONTB 


SPECS (3) 


* 


XRIGHT 


SPECS(J«) * 


FONTH 


SPECS (4) 


* 


XLEFT 


SPECS! 19) 




SPECS (5) 


* 


YTOP 


SPECS (2fl) 




SPECS (6) 


* 


YBOT 


SPECS(21) 




SPECS (7) 


* 


XLNGTH 


SPECS (22) 




SPECS [8] 


* 


YLNGTH 


SPECS (23) 




SPECS [9) 






SPECS (24) 




SPECS(IO) 






SPECS (25) 




SPECS(n) 


* 


TOOL 


SPECS (26) 




SPECS (12) 


* 


CCTAPE 


SPECS (27) 




SPECS (13) 


* 


POINTS 


SPECS (28) 




SPECSU4) 


* 


XSKIPS 


SPECS (29) 




SPECS (15) 


* 


YSKIPS 


SPECS[30) * 


STAPE 



The first point is defined by the coordinate pair [X(l) , Y(l)]; 
the next sequential point is [X(1+XSKIPS) , Y(1+YSKIPS) ] , which 
is followed by IX(1+2XSKIPS) , Y(1+2YSKIPS)J , etc. 

C, Routines Used: NONLIN, PSLILI, WRGHT, SIGNON 
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Example 





DIMENSION SPECS(30), X(10), Y(10) 


C 


SET XSKIPS.YSKIPS 


c 


SET XDIST, YDIST (IN INCHES) 




SPECS(14) = T. 




SPECS(l) = =877 




SPECS(15) = 1. 




SPECS(2) = .877 


C 


SPECIFY SYMBOL NUMBER 


c 


SET XRIGHT, XLEFT 




SPECS(16) = 3. 




SPECS(3) = 5**5 


C 


SET FONTB.FONTH (IN INCHES) 




SPECS(4) = .5**. 5 




SPECS(17) = 0.1 


c 


SET YTOP.YBOT 




SPECS(18) = 0.1 




SPECS(5) = 10.0 


C 


SPECIFY SCRATCH FILE NUMBER 




SPECS(6) =1.0 




SPECS(30) = 97. 


c 


SET XLNGTH.YLNGTH (IN INCHES) 


C 


SETUP SAMPLE X,Y ARRAYS 




SPECS(7) = 2.5 




DO 10 1=1,10 




SPECSC8) =2.5 




RI = FL0ATfI)/2. 


c 


SPECIFY TOOL (NORMALLY ONE) 




X(I) = RI**RI 




SPECS(ll) = 1. 




Y(D = I 


c 


SPECIFY INTERMEDIATE FILE NUMBER 


10 


CONTINUE 




SPECS(12) = 99. 


C 


CALL SYMBOL PLOT ROUTINE 


c 


SPECIFY NUMBER OF POINTS 




LOG X, LINEAR Y 




SPECS(13) = 10. 


C 


CALL PSLGLI (X,Y, SPECS) 



Reference' 
Point 




YBOT 
(6) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine PSLGLG 
Purpose 

To symbol-plot a set of numerical values (X ordlnates) against another 
set (Y ordlnates) in a rectangular coordinate system having loga- 
rithmic function scales for both axes. 



Usage 



A. FORTRAN call statement 
CALL PSLGLG {K,V, SPECS) 

B. Description of call list arguments 

X An array containing the X ordlnates of data points to 

be processed. Values are floating-point. All X values 
must be all positive, or all negative, and all non-zero. 

y An array containing the Y ordlnates of data points to 

be processed. Values are floating-point. All Y values 
must be all positive, or all negative, and all non-zero. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by the * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS! I) 


* 


XDIST 


SPECS [16) 


* SYMBOL 


SPECS [2) 


* 


YDIST 


SPECS U 7) 


* FONTB 


SPECS (3) 


* 


XRIGHT 


SPECSiU) 


* FONTH 


SPECS [4) 


* 


XLEFT 


SPECS (19) 




SPECS (5) 


* 


YTOP 


SPECS [20) 




SPECS (6) 


* 


YBOT 


SPECS[21) 




SPECS (7) 


* 


XLNGTH 


SPECS (22) 




5KtU5l«J 


* 


YLNGTH 


SPECS (23) 




SPECS (9) 






SPECS (24) 




SPECS [10) 






SPECS (25) 




SPECS [11) 


* 


TOOL 


SPECS [26) 




SPECS ( 7 2 J 


* 


CCTAPE 


SPECS (27) 




SPECS (1 3] 


* 


POINTS 


SPECS (2S) 




SPECS [14) 


* 


XSKIPS 


SPECS (29) 




SPECS [15) 


* 


YSKIPS 


SPECS [30) 


* STAPE 



The first point is defined by the coordinate pair [X(l) , Y(l)]; 
the next sequential point is [X(1+XSKIPS) , Y(1+YSKIPS) ] , which 
is followed by [X(1+2XSKIPS) , Y(1+2YSKIPS) ] , etc. 

C. Routines Used: NONLIN, PSLILI, WRGHT, SIGNON 
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Example 



C 

C 

C 

C 
r 

C 



DIMENSION SPECS(30), X(10), Y(10) 

SET XDIST ; YD I ST (IN INCHES) 

SPECS(i) = 0.877 

SPECS(2) = 0.877 

SET XRIGHT, XLEFT 

SPECS(3) = 100. 

SPECS(4) = 1. 

SET YTOP, YBOT 

SPECS(5) = 2.**10 

SPECS(6) = 2. 

SET XLNGTH, YLNGTH (IN INCHES) 



cnrrc In \ 



o c 



SPECS(8) = 2.5 

SPECIFY TOOL* (NORMALLY ONE) 

SPECS(ll) = 1. 

SPECIFY INTERMEDIATE FILE NUMBER. 

SPECS(12) = 99. 

SPECIFY NUMBER OF POINTS 

SPECS(13) = 10. 



10 



C 
C 



SPECIFY XSKIPS, YSKIPS 

SPECS(14) = 1. 

SPECS(15) = 1. 

SPECIFY SYMBOL NUMBER 

SPECS(16) = 4. 

SPECIFY FONTB, FONTH (INCHES) 

SPECS(17) = 0.1 

SPECS(18) = 0.1 

SPECIFY SCRATCH FILE NUMBER 

SPECS(30) = 97. 

SETUP SAMPLE X,Y ARRAYS 

nn in i = i in 

X(I) = 1**2 

Y(I) = 2.**I 

CONTINUE 

CALL SYMBOL PLOT ROUTINE 

LOG X, LOG Y 

CALL PSLGLG (X,Y, SPECS) 



C3 CO 




Reference * - X ?{F 
Point u; 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine PSPOLR 



Purpose 



To symbol-plot data onto a rectangular coordinate system with data 
given in polar coordinates. t 



Usage 



FORTRAN call statement 



CALL PSLILI (R.THETA.SPECS) 
B. Description of call list arguments 

R An array containing the vector lengths of data points to 
be processed. Values are floating-point. 

THETA An array containing the angles, given in radians of data 
points to be processed. Values are floating-point. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parametc 


ir 


Mnemonic 
XDIST 


Parameter 




Mnemonic 


SPECS ( J | 


* 




SPECS (l\ 


* 


YDIST 


SPECS! /I) 


* 


TOOL 


SPECS (31 


* 


XRIGHT 


SPECS (12) 


* 


CCTAPE 


SPECS (4] 


* 


XLEFT 


SPECS { 13) 


* 


POINTS 


SPECS [5] 


* 


YTOP 


SPECSH4) 


* 


XSKIPS 


SPECS [6\ 


* 


YBOT 


SPECS! J5) 


* 


YSKIPS 


SPECS (7 \ 


* 


XLNGTH 


SPECS! /6) 


* 


SYMBOL 


SPECSls) 


* 


YLNGTH 


SPECS (17) 


* 


FONTB 


SPECS (9) 






SPECS ( 18) 
and 


* 


FONTH 








SPECS130) 


* 


STAPE 



The first point is defined by the coordinate pair [R(1),THETA(1)] ; 
the next sequential points is [R(1+XSKIPS) , THETA (1+YSKIPS)] , which 
is followed by [R(1+2XSKIPS) ,THETA(1+2YSKIPS)] , etc. 

Routines used: POLAR, DATAPE, PSLILI, SIGNON, WRGHT 



The given polar coordinates are not changed. 
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D. Example 



DIMENSION SPECS(30) ,R(25) ,THETA(25) 
C SET XDIST.YDIST f IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XRIGHT, XLEFT 

SPECS(3) = 100.0 

SPECS(4) = -100.0 
C SET YTOP.YBOT 

SPECS(5) = 100.0 

SPECS(6) = -100.0 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) =2.5 

SPECS (8) =2.5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(11 ) = 1 . 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99 
C SPECIFY NUMBER 'OF POINTS 

SPECS(13) = 25. 



C SET XSKIPS.YSKIPS 

SPECSM4) = 1. 

SPECS(15) = 1. 
C SPECIFY SYMBOL NUMBER 

SPECS (16) = 5. 
C SET FONTB.FONTH (IN INCHES) 

SPECS(17) = 0.1 

SPECS(18) = 0.1 
C SPECIFY SCRATCH FILE NUMBER 

SPECS(30) = 97. 
C SETUP SAMPLE R.THETA ARRAYS 



nn in 

w ■ w 



T=l OK 



RI = I 

R(I) = 5*(I-1) 

THETA(I) = RI/2. 
10 CONTINUE 
: CALL POLAR SYMBOL PLOT ROUTINE 

CALL PSPOLR (R.THETA, SPECS) 



■-■ CO 

x 



> 



oo 



Q 

>- 



CM 



Reference ^* — ^7 * ?' 
Point Uj 



D 






D 
D 



-CL 



XLNGTH 



(7) 



YTOP 
(5) 



-YBOT 
(6) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 



IV-5.13 



Routines to Construct Straight Lines Throug h Data 

Routine Names 

SLLILI, SLLILG, SLLGLI, SLLGLG, SLPOLR 
Purpose 

To construct straight lines between consecutive data points. The 

coordinate system may be linear X and linear Y (SLLILI), linear 

X and logarithmic Y (SLLILG), logarithmic X and linear Y 

(SLLGLI), or logarithmic X and logarithmic Y (SLLGLG), or polar (SLPOLR) 



Method 



The routine examines each pair of consecutive points. If both 
points lie within the defined plotting area, including on its 
boundaries, the routine constructs a straight line that connects 
the two points. If either, or both, of the points (lie(s) outside 
the defined plotting area, the routine constructs between the two 
points the segment of the line common with the defined plotting area, 
If the point set consists of a single point, the routine plots the 
point if the point does not lie outside the defined plotting area. 

Restrictions 

A. Point count: One point minimum. 

B. Data Range: Range is limited only by the range of a floating- 

point number (single precision) . 

Usage 

See the following individual subroutine writeups for: 

A. FORTRAN call statement 

B. Description of call list arguments 

C. Routines Used 

D. Example 
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Subroutine SLLILI 



Purpose 



To aerially connect with straight lines a set of points in a 
rectangular coordinate system having linear function scales for 
both axes. 



Usage 



A. FORTRAN call statement: 
CALL SLLILI (X, /, SPECS) 

B. Description of call list arguments 

X An array containing the X ordaintes of data points to 
be processed. Values are floating-point. 

V An array containing the Y ordinates of data points to 

be processed. Values are floating-point. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prio to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS ( 1 ) 


* 


XDIST 


SPECS (9) 






SPECS(2) 


* 


YDIST 


SPECS (10) 






SPECS (3) 


* 


XRIGHT 


SPECS (11) 


* 


TOOL 


SPECS (4) 


* 


XLEFT 


SPECS [12) 


* 


CCTAPE 


SPECS (5) 


* 


YTOP 


SPECS (13) 


* 


POINTS 


SPECS (6) 


* 


YBOT 


SPECS (14) 


* 


XSKIPS 


SPECS (7) 


* 


XLNGTH 


SPECS(1S) 


* 


YSKIPS 


SPECS {8) 


* 


YLNGTH 









The first point is defined by the coordinate pair [X(l) , Y(l)] ; 
the next sequential point is [X(1+XSKIPS) , Y(1+YSKIPS)] , which 
is followed by [X(1+2XSKIPS) , Y(1+2YSKIPS)] , etc. 

Routines Used: SIGNON, WRGHT 
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D. Example 



DIMENSION SPECS(30), X(10), Y(10) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = =877 

SPECS(2) = .877 
C SET XRIGHT, XLEFT 

SPECS(3) = 10.0 

SPECS(4) = 1.0 
C SET YTOP, YBOT 

SPECS(5) =. 10.0 

SPECS(6) = 1.0 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFy'tOOL (NORMALLY SET TO ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SPECIFY NUMBEROF POINTS 

SPECS(13) = 10. 
C SET XKSIPS, YSKIPS 

SPECS(14) = 1. 

SPECS(15) = 1. 



SETUP X,Y DATA ARRAYS 



X(D 
Yfl) 
X(2) 
Y(2) 
X(3) 
Y(3) 
X(4) 
Y(4) 
X(5) 
Y(5) 
X(6) 
Y(6) 
X(7) 
Y(7) 
X(8) 
Y(8) 
X(9) 
Y(9) 



0.1 

0,1 

0.5 

0.2 

1.2 

0.7 

1.6 

1.7 

2.5 

3.0 

3.5 
a. 9 

5.3 
7.2 
8.1 
6,2 
9.2 
7.3 



X(10) = 10.5 

Y(10) = 10.5 
C CALL STRAIGHT LINE ROUTINE 
C LINEAR X, LINEAR Y 

CALL SLLILI (X,Y, SPECS) 



Reference 
Point 




YBOT 
(6) 



XDIST 

TT7 

See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SLLILG 



Purpose 



To aerially connect with straight lines a set of points in a 
rectangular coordinate system having a linear function scale for 
the X-axis and a logarithmic function scale for the Y-axis. 



Usage 



A. FORTRAN call statement: 
CALL SLLILG (X, /, SPECS) 

B. Description of call list arguments 

X An array containing the X ordinates of data points to 
be processed. Values are floating-point, 

y An array containing the Y ordinates of data points to 

be processed. Y ordinate range must contain floating- 
point numbers (single precision) which are all positive 
or negative; and non-zero. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameter* indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


SPECS ( 7 J 


* 


xniST 


SPECS (2i 


* 


YDIST 


SPECS (3) 


* 


XRIGHT 


SPECS (4) 


* 


XLEFT 


SPECS (5) 


* 


YTOP 


SPECS [6) 


* 


TBOT 


SPECS (7) 


* 


XLNGTH 


SPECS18) 


* 


YLNGTH 



Parameter 



Mnemonic 



SPECS (9) 






SPECS (10) 






SPECS(11) 


* 


TOOL 


SPECSi 12) 


* 


CCTAPE 


SPECS! 13) 


* 


POINTS 


SPECS [14) 


* 


XSKIPS 


SPECS (J5) 

• 


* 


YSKIPS 


SPECS (30) 


* 


STAFE 



Data points are defined as follows: The first point is defined 
by the coordinate pair [X(l) , Y(l)l; the next sequential point 
is [X(1+XSKIPS) , Y(I+YSKIPS)], which is followed by 
[X(1+2XSKIPS) . Y(1+2YSKIPS)], etc 

Routines Used: NONLIN, SLLILI, SIGNON, WRGHT 
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D. 



Example 



DIMENSION SPECS(30), X(10), Y(10) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XRIGHT, XLEFT 

SPECS(3) = 10.0 

SPECS(4) = 1.0 
C SET YTOP, YBOT 

SPECS(5) = 10.0 

SPECS(6) = 1.0 
C SET XLNGTH, YLNGTH 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFY TOOL* (NORMALLY ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 



C SPECIFY NUMBER OF POINTS 

SPECS H 3) =10, 
C SET XSKIPS, YSKIPS 

SPECS(14) = 1. 

SPECS(15) = 1. 
C SPECIFY SCRATCH FILE NUMBER 

SPECS(30) = 97. 
C SETUP SAMPLE X,Y ARRAYS 

DO 10 I = 1,10 

X(D = I 

Y(I) - I 
10 CONTINUE 
C " CALL ^STRAIGHT LINE ROUTINE 
C LINEAR X, LOG Y 

CALL SLLILG 



Reference 
Point 




YTOP 
(5) 



YBOT 
(6) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SLLGLI 



Purpose 



To aerially connect with straight lines a set of points in a 
rectangular coordinate system having a logarithmic function scale 
for the X-axis and a linear function scale for the Y-axis. 



Usage 



A. FORTRAN call statement: 
CALL SLLGLI (X, /, SPECS) 

B. Description of call list arguments 

X An array containing the X ordinates of data points to 
be processed. X ordinate range must contain floating- 
point numbers (single precision) which are all positive 
or all negative, and non-zero. 

V An array containing the Y ordinates of data points to 

be processed. Values are floating-point. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by the * to be specified prior to callinf it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS ( 1 ) 


* 


XDIST 


SPECS (9) 






SPECS (21 


* 


YDIST 


SPECS! JO) 






SPECS (3) 


* 


XRIGHT 


SPECS { 11) 


* 


TOOL 


SPECS [4) 


* 


XLEFT 


SPECS (12) 


* 


CCTAPE 


SPECS (51 


* 


YTOP 


SPECS (73) 


* 


POINTS 


SPECS [6) 


* 


YBOT 


SPECS (14) 


* 


XSKIPS 


SPECS {7) 


* 


XLNGTH 


SPECS (15) 


* 


YSKIPS 


SPECS (S) 


* 


YLNGTH 


• 
• 












SPECS (30) 


* 


STAPE 



Data points are defined as follows: The first point is defined 
by the coordinate pair [X(l) , Y(l)];the next sequential point is 

[X(1+XSKIPS) , YU+YSKIPS)], which is followed by 

[X(1+2XSKIPS) , Y(1+2YSKIPS)], etc. 

Routines Used: NONLIN, SLLILI, SIGNON, WRGHT 
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Example 



DIMENSION SPECS(30), X(10), Y(10) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = .877 

SPECS(2) = .877 
C SET XRIGHT, XLEFT 

SPECS(3) = 5**5 

SPECS(4) = .5**. 5 
C SET YTOP,YBOT 

SPECS(5) = 10.0 

SPECS(6) = 1.0 
C SET XLNGTH.YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(I2) = 97. 
C SPECIFY NUMBER OF POINTS 

SPECS(13) = 10. 



10 



r 

c 



SET XSKIPS.YSKIPS 
SPECSM41 * 1 

SPECS (15) = 1. 

SPECIFY SCRATCH FILE NUMBER 

SPECS (30) = 97. 

SETUP SAMPLE X,Y ARRAYS 

DO 10 1=1,10 

RI = FL0AT(I)/2. 

X(I) = RI**RI 

Y(I) - I 

CONTINUE 

CALL STRAIGHT LINE ROUTINE 

LOG X, LINEAR Y 

CALL SLLGLI (X,Y, SPECS) 






X 
C3-— « 

l-H PO 

oc 

X 



GO 



Q 

>~ 



Reference 
Point 





■ 


' 












/ 


m 


X 

1- 

Z 
_ 
>- 


— N 

00 


















t 


XLNGTH 






F 


(7) 




L XDIST _ 






(1) 







YTOP 
(5) 



YBOT 
(6) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SLLGLG 



Purpose 



To serially connect with straight lines a set of points in a 
rectangular coordinate system having logarithmic function scales 
for both axes. 



Usage 
A. 



FORTRAN call statement: 

CALL SLLGLG (X, /, SPECS) 

Description of call list arguments 

X An array containing the X ordaintes of data points to 
be processed. X ordainte range must contain floating- 
point numbers (single precision) which are all positive 
or all negative, and non-zero. 

V An array containing the Y ordinates of data points to 

be processed. Y ordinate range must contain floating- 
point numbers (single precision) which are all positive 
or negative; and non-zero. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECSIJ) 


* 


XDIST 


SPECS (9) 






SPECS(2) 


* 


YDIST 


SPECS (JO) 






SPECS (3) 


* 


XRIGHT 


SPECSMU 


* 


TOOL 


SPECS (4) 


* 


XLEFT 


SPECS (12) 


* 


CCTAPE 


SPECS (5) 


* 


YTOP 


SPECSH3) 


* 


POINTS 


SPECS [6) 


* 


YBOT 


SPECS [14] 


* 


XSKIPS 


SPECS (7) 


* 


XLNGTH 


SPECSUS) 


* 


YSKIPS 


SPECS (*) 


* 


YLNGTH 


* 
• 












SPECS(30) 


* 


STAPE 



Data points are defined as follows: The first point is defined 
by the coordinate pair [X(l) , Y(l)]; the next sequential point is 
[X(1+XSKIPS),Y(1+YSKIPS)], which is followed by 
[XU+2XSKTPS) , Y(1+2YSKIPS)], etc. 

Routines Used: NONLIN, SLLILI, SIGNON, WRGHT 
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D. Example 



C 
C 
C 
C 






- 11UI IbJ / 



DIMENSION SPECS(30), X(10), Y(10) 
cft Ynrcr vnrcT 

SPECS(l) = 0.877 

SPECS(2) = 0.877 

SET XRIGHT, XLEFT 

SPECS(3) = 100. 

SPECS(4) = 1. 

SET YTOP, YBOT 

SPECS(5) = 2.**10 

SPECS16) = 2. 

SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(8) = 2.5 

SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 

SPECIFY NUMBER'OF POINTS 

SPECS(13) = 10. 



10 



I* 



SPECIFY XSKIPS, YSKIPS 

cocrcftA\ _ 1 

•js lm \ n / — 1 . 

SPECS (15) = 1. 

SPECIFY SCRATCH FILE NUMBER 

SPECS (30) = 97. 

SETUP SAMPLE X,Y ARRAYS 

DO 10 1=1,10 

X(I) = 1**2 

Y(I) = 2.**I 

CONTINUE 

CALL STRAIGHT LINE ROUTINE 

LOG X, LOG Y 

CALL SLLGLG (X,Y, SPECS) 



•— 1 CO 
X 







■ 












1 










1— 

CD 

z 
>- 


00 
























. 








m 


1— 


C\J 




XLNGTH 






1— 1 

Q 

>- 


(7) 










XDIST,_ 









YTOP 
(5) 



YBOT 
(6) 



Point ^ 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SLPOLR 



Purpose 



To construct straight lines between consecutive data points given 
in polar coordinates . t 



Usage 



FORTRAN call statement 

CALL SLPOLR (R, THETA, SPECS) 

Description of call list arguments 

R An array containing the vector lengths of data points to 
be processed. Values are floating-point. 

THETA An array containing the angles, given in radians of data 
points to be processed. Values are floating-point. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS (?) 


* 


XDIST 


SPECS (9) 






SPECS (2) 


* 


YDIST 


SPECS (10) 






SPECS (3) 


* 


XRIGHT 


SPECS (11) 


* 


TOOL 


SPECS [4) 


* 


XLEFT 


SPECS [12] 


* 


CCTAPE 


SPECS (5) 


* 


YTOP 


SPECS (13) 


* 


POINTS 


SPECS (6) 


* 


YBOT 


SPECS (14) 


* 


XSKIPS 


SPECS (7) 


* 


XLNGTH 


SPECS (15) 


* 


YSKIPS 


SPECS (SI 


* 


YLNGTH 


and 












SPECS (30) 


* 


STAPE 



The first point is defined by the coordinate pair [R(1),THETA(1) ] ; 
the next sequential point is [R(1+XSKIPS) , THETA (1+YSKIPS)] , which 
is followed by [R(1+2XSKIPS) ,THETA(1+2YSKIPS)] , etc. 



Routines Used: 



POLAR, DATAPE, SLLILI, SIGNON, WRIGHT 



The given polar coordinates are not changed. 
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D. Example 



DIMENSION SPECS(30) ,R(25) ,THETA(25) 
C SET XDIST.YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XRIGHT.XLEFT 

SPECS(3) = 100.0 

SPECS(4) = -100.0 
C SET YTOP.YBOT 

SPECS(5) = 100.0 

SPECS(6) = -100.0 
C SET XLNGTH.YLNGTH (IN INCHES) 

SPECS{7) = 2.5 

SPECS(8) = 2.*5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SPECIFY NUMBER OF POINTS 

SPECS(13) = 25. 
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SET XSKIPS, YSKIPS 

SPECSM41 = 1." 

SPECS(15) = 1. 

SPECIFY SCRATCH FILE NUMBER 

SPECS(30) = 97. 

SETUP SAMPLE R.THETA ARRAYS 

DO 10 1=1,25 

RI = I 

R(I) = 5*(I-1) 

THETA(I) = RI/2. 

CONTINUE 

CALL POLAR STRAIGHT LINE ROUTINE 

CALL SLPOLR(RJHETA.SPECS) 




■ 



YBOT 
(6) 



Reference ' - *?ffi " 
Point (i} 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Routines Employing Parabolic Fairing Technique 
to Construct a Trend Curve Through Data 



Routine Names 

PFLILI, PFLILG, PFLGLI, PFLGLG, PFPOLR 

Purpose 

To construct via a parabolic fairing technique a trend curve 
through a set of points. The coordinate system may be linear X 
and linear Y (PFLILI), linear X and logarithmic Y (PFLILG), 
logarithmic X and linear Y (PFLGLI) .logarithmic X and 
logarithmic Y (PFLGLGl or polar (PFPOLR). 



Method 



A. Point set contains less that three points: 

If the given point set consists of two points, the trend curve 
is the straight line segment that joins the two points. If 
the point set consists of a single point, the trend curve is 
the point. The routine constructs only that portion of the 
trend curve common within the defined plotting area. 

B. Point set contains three or more points: 

The routine interpolates a series of points to establish the 
trend curve. The interpolation scheme employs a group of rules, 
called "three-point rules", plus a blending rule. The three- 
point rules pertain to the solution of the two parabolic 
equations : 

Y = aX 2 + bX + c 

X = AY 2 + BY + C 

The blending rule combines double solutions of these equations 

to produce a well-behaved trend curve such that there is main- £ 

tained a one-to-one correspondence between the relative extremes a 

in the data and the relative extremes implied by the curve. » 

a 

The routine constructs only that portion of the trend curve com- » 

mon with the defined plotting area. 6 

C If two consecutive points lie either in a horizontal or vertical 
line, the routine connects these two points with a straight line. 
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Restrictions 

A. Point Count: One point minimum. 

B. Data Range: Range is limited only by the range of a floating- 

point number (single precision) . 

Usage 

See the following individual subroutine writeups for: 

A. FORTRAN call statement 

B. Description of call list arguments 

C. Routines Used 

D . Example 
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Subroutine PFLILI 
Purpose 

To construct via a parabolic fairing technique a trend curve through 
a set of points in a rectangular coordinate system having linear 
functions scales for both axes. 



Usage 



FORTRAN call statement 

CALL PFLILI (X./.BUFX.BUF/, SPECS) 

Description of call list arguments: 

X An array containing the X ordinates of data points to 
be processed. Values are floating-point. 

V An array containing the Y ordinates of data points to 

be processed. Values are floating-point. 

BUFX An array of 500 iq consecutive words provided as a work 
region for the routine to use to process the data. 

BUFy An array of 500 10 consecutive words provided as a work 
region for the routine to use to process the data. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS (1) 


* 


XDIST 


SPECS (9) 






SPECS (2) 


* 


YDIST 


SPECS {10) 






SPECS (3) 


* 


XRIGHT 


SPECS(11) 


* 


TOOL 


SPECS (4) 


* 


XLEFT 


SPECS (12) 


* 


CCTAPE 


SPECS (5) 


* 


YTOP 


SPECS (13) 


* 


POINTS 


SPECS (6) 


* 


YBOT 


SPECS (14) 


* 


XSKIPS 


SPECS (7) 


* 


XLNGTH 


SPECS (15) 


* 


YSKIPS 


SPECS (*] 


* 


YLNGTH 









Data points are defined as follows: The first point is 
defined by the coordinate pair [X(l), Y(l)]; the next 
sequential point is [X(1+XSKIPS), Y(1+YSKIPS)] , which is 
followed by [X(1+2XSKIPS) , Y(1+2YSKIPS)] , etc. 

Routines Used: FAIR, SLLILI, SIGNON, WRGHT 
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D. Example 



DIMENSION SPECSC30), X(lQl, Y(1Q) 

DIMENSION BUFX(500), BUFY{500J 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = .877 

SPECS(2) = .877 
C SET XRIGHT, XLEFT 

SPECS(3) = 10.0 

SPECS(4) = 1.0 
C SET YTOP, YBOT 

SPECS(5) = 10.0 

SPECS(6) = 1.0 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY SET TO ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SPECIFY NUMBER OF POINTS 

SPECS(13) = 10. 
C SET XSKIPS, YSKIPS 

SPECS(14) = 1. 

SPECS(15) = 1. 



SET X,Y DATA ARRAYS 





X(l) = 0.1 




Y(l) = 0.1 




X(2) = 0.5 




Y(2) = 0.2 




X(3) = 1.2 




Y(3) = 0.7 




X(4) = 1.6 




Y(4 = 1.7 




X(5) = 2.5 




Y(5) = 3.0 




X(6) = 3.5 




Yf6l = 4.2 




X(7) = 5.3 




Y(7) = 7.2 




X(8) = 8.1 




Y(8) = 6.2 




X(9) = 9.2 




Y(9) = 7.3 




X(10) = 10.5 




Y(10) = 10.5 


c 


CALL PARABOLIC FAIRING ROUTINE 


c 


LINEAR X, LINEAR Y 




CALL PFLILI (X,Y,BUFX,BUFY, SPECS) 



:r 




i— i 


ro 




cc 


«- -* 




X 








' 


YIOP 






(5) 



Reference 
Point 




See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine PFLILG 
Purpose 

To construct via a parabolic fairing technique a trend curve through 
a set of points in a rectangular coordinate system having a linear 
function scale for the X-axis and a logarithmic function scale for 
the Y-axis. 



Usage 



A. FORTRAN call statement: 

CALL PFLILG (X.y.BUFX.BUF/, SPECS) 

B. Description of call list arguments: 

X An array containing the X ordinates of data points to 
be processed. Values are floating-point. 

V An array containing the Y ordinates of data points to 

be processed. Y ordinate range must contain floating- 
point numbers (single precision) which are all positive, 
or all negative, and non-zero. 

BUFX An array of 500iq consecutive words provided as a work 
region for the routine to use to process the data. 

BUFV An array of 500iq consecutive words provided as a work 
region* for the routine to use to process the data. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 




Mnemonic 


SPECS! 1) * 


XDIST 


SPECS (9) 






SPECS (2) * 


YDIST 


SPECS (10) 






SPECS (3) * 


XRIGHT 


SPECSU1) 


* 


TOOL 


SPECS (4) * 


XLEFT 


SPECSI12) 


* 


CCTAPE 


SPECS (51 * 


YTOP 


SPECS{13) 


* 


POINTS 


SPECS (6) * 


YBOT 


SPECS (14) 


* 


XSK1PS 


SPECS (7) * 


XLNGTH 


SPECS (15) 


* 


YSKIPS 


SPECS [S] * 


YLNGTH 


• 
• 










SPECS [30] 


* 


STAPE 



Data points are defined as follows: The first point is 
defined by the coordinate pair [X(l) , Y(l)]; the next 
sequential point is [X(1+XSKIPS) , Y(1+YSKIPS)] , which is 
followed by [X(1+2XSKIPS) , Y(1+2YSKIPS) ] , etc. 

Routines Used: NONLIN, PFLILI, FAIR, SLLILI, SIGNON, WRGHT 
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D. Example 



DIMENSION SPECS(30), X(10), Y(10) 

DIMENSION BUFX(500), BUFY (500) 
t iti AUiai, TUidi U" inv.ru: a; 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XRIGHT, XLEFT 

SPECS(3) = 10.0 

SPECS(4) = 1.0 
C SET YTOP, YBOT 

SPECS(5) = 10.0 

SPECS(6) = 1.0 
C SET XLNGTH, YLNGTH 

SPECS(7) = 2.5 

SPECS(8) =2.5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(11 ) = 1 . 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
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C 
C 



SPECIFY NUMBER OF POINTS 

SPECS(13) = 10. 

it i AoKiro, i3Mri 

SPECS(14) = 1. 

SPECSC15) = 1. 

SPECIFY SCRATCH FILE NUMBER 

SPECS (30) = 97. 

SETUP SAMPLE X,Y, ARRAYS 

DO 10 I = 1,10 

X(I) ■ I 

Y(D - I 

CONTINUE 

CALL PARABOLIC FAIRING ROUTINE 

LINEAR X, LOG Y 

CALL PFLILG (X.Y.BUFX, BUFY, SPECS) 



Reference 
Point 



—> CO 
X 



1 


J 


' 


, 








»— 

z 
_l 
>- 


00 


















i 
CM 


XLNGTH 




t— 1 
Q 

>■ 


(7) "' 




1 


' XDIST ^ 








(1) 







YTOP 
(5) 



YBOT 
(6) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine PFLGLI 
Purpose 

To construct via a parabolic fairing technique a trend curve through 
a set of points in a rectangular coordinate system having a logari- 
thmic function scale for the X-axis and a linear function scale for 
the Y-axis. 



Usage 



A. FORTRAN call statement: 

CALL PFLGLI (X.y.BUFX.BUFV, SPECS) 

B. Description of call list arguments: 

X An array containing the X ordinates of data points to 
be processed. X ordinate range must contain floating- 
point numbers (single precision) which are all positive, 
or all negative, and non-zero. 

V An array containing the Y ordinates of data points to 

be processed. Values are floating-point. 

BUFX An array of 500iq consecutive words provided as a work 
region for the routine to use to process the data. 

BUFy An array of 500 m consecutive words provided as a work 
region for the routine to use to process the data. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 

SPECS (?) 
SPECS (2) 
SPECS (3) 
SPECS (4] 
SPECS (5) 
SPECS (6) 
SPECS (7) 
SPECS [8] 



* 
* 
* 
* 
* 
* 
* 
* 



Mnemonic 

XDIST 

YDIST 

XRIGHT 

XLEFT 

YTOP 

YBOT 

XLNGTH 

YLNGTH. 



Parameter 


Mnemonic 


SPECS (9) 




SPECS (10) 




SPECS{11) * 


TOOL 


SPECS (12) * 


CCTAPE 


SPECSU3) * 


POINTS 


SPECS(U) * 


XSKIPS 


SPECS (J 5] * 


YSKIPS 



SPECS 130) * STAPE 



Data points are defined as follows: The first point is 
defined by the coordinate pair [X(l) , Y(l)]; the next 
sequential point is [X(1+XSKIPS) , Y(1+YSKIPS)] , which is 
followed by [XU+2XSKIPS) , Y(1+2YSKIPS)] , etc. 

Routines Used: NONLIN, PFLILI, FAIR, SLLILI, SIGNON, WRGHT 
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D. Example 



DIMENSION SPECS(30), X(10), Y(10) 
DIMENSION BUFX(500), BUFY(500) 



rrr vmt—r 
OLI AUIOI 



\/r\ t(*t 
TU13I 






nin tr-r- \ 



SPECS(l) = .877 

SPECS(2) = .877 
C SET XRIGHT, XLEFT 

SPECS(3) = 5**5 

SPECS(4) = .5**. 5 
C SET YTOP, YBOT 

SPECS(5) = 10.0 

SPECS(6) = 1.0 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = .25 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(1 2) = 97. 
C SPECIFY NUMBEROF POIkTS 

SPECS(13) = 10. 
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C 
C 



SET XSKIPS.YSKIPS 
SPECS(14) = 1. 






i . 



SPECIFY SCRATCH FILE NUMBER 

SPECS(30) = 97. 

SETUP SAMPLE X,Y ARRAYS 

DO 10 1=1,10 

RI = FL0AT(i)/2. 

X(I) = RI**RI 

Y(I) = I 

CONTINUE 

CALL PARABOLIC FAIRING ROUTINE 

LOG X, LINEAR Y 

CALL PFLGLI (X.Y.SPECS) 




Reference »— — XD I ST » 



a 
a 
a 
a 
a 
a 
a 
a 
a 
a 



Point 



(1) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine PFLGLG 



Purpose 



To construct via a parabolic fairing technique a trend curve through 
a set of points in a rectangular coordinate system having logarithmic 
function scales for both axes. 



Usage 



FORTRAN call statement 

CALL PFLGLG (X,y,B(iFX,8UFy, SPECS) 

Description of call list arguments 

X An array containing the X ordinates of data points to 
be processed. X ordinate range must contain floating- 
point numbers (single precision) which are all positive, 
or all negative, and non-zero. 

y An array containing the Y ordinates of data points to 

be processed. Y ordinate range must contain floating- 
point numbers (single precision) which are all positive, 
or all negative, and non-zero. 

8UFX An array of 500io consecutive words provided as a work 
region for the routine to use to process the data. 

BUFy An array of 500io consecutive words provided as a work 
region for the routine to use to process the data. 

SPECS An array containing plot construction parameter. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 




Mnemonic 


SPECS! I) * 


XDIST 


SPECS (9) 






SPECS (2) * 


YDIST 


SPECS (10) 






SPECS (3) * 


XRIGHT 


SPECS(11) 


* 


TOOL 


SPECS {4) * 


XLEFT 


SPECS (12) 


* 


CCTAPE 


SPECS (5) * 


YTOP 


SPECS (13) 


* 


POINTS 


SPECS (6) * 


YBOT 


SPECS(U) 


* 


XSKIPS 


SPECS {7) * 


XLNGTH 


SPECS! J 5) 


* 


YSKIPS 


SPECS [8] * 


YLNGTH 


■ 
• 










SPECS (30) 


* 


STAPE 



Data points are defined as follows: The first point is 
defined by the coordinate pair [X(l) , Y(l)]; the next 
sequential point is [X(1+XSKIPS) , Y(1+YSKIPS) ] , which is 
followed by tx(l+2XSKIPS) , Y(1+2YSKIPS)] , etc. 

Routines Used: NONLIN, PFLILI, FAIR, SLLILI, SIGNON, WRGHT 
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D. Example 



DIMENSION SPECS(30), X(10), Y(10) 



DTMFWQTnW RMFY 






qiicW cnn\ 



C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XRIGHT, XLEFT 

SPECS(3) = 100. 

SPECS(4) = 1. 
C SET YT0P.YB0T 

SPECS(5) = 2.**10 

SPECS(6) = 2. 

r CCT VI MCTU VI MPTU fTM TMrurcX 

\j oli nLiiuui, iliiuiii V*" Hl^nLJ/ 

SPECS(7) = 2.5 

SPECS(8) = 25. 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SPECIFY NUvBER OF POINTS 

SPECS(13) = 10. 
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SPECIFY XSKIPS, YSKIPS 

crjcre/i/i \ « i 
•jr i-ovj\ it/ - i . 

SPECS(15) = 1. 

SPECIFY SCRATCH FILE NUMBER 

SPECS(30) = 97. 

SETUP SAMPLE X,Y ARRAYS 

DO 10 1=1,10 

X(I) = 1**2. 

Y(I) = 2.**I 

CONTINUE 

CALL PARABOLIC FAIRING ROUTINE 

LUU A, LUla T 

CALL PFLGLG(X,Y,BUFX,BUFY, SPECS) 







UJ 

_l 
X 


"(J- 




•jo. 

»— A 

X 


ro 




' 


' 




1 


'„ 










1 




t- 

_ 
>■ 


00 

— 




/ 








■ 










V 


, 


, 










h- 

00 


CM 




XLNGTH 






Q 

>- 




\D 






Reference 


XDIST 

^* r^ •" 











YTOP 
( ) 



YBOT 
(5) 



a 



a 
a 
a 
a 
a 
b 



Point 



(1) 

See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine PFPOLR 



Purpose 



To construct a trend curve onto a rectangular coordinate system with 
data given in polar coordinates. t 



Usage 



A. 



B. 



FORTRAN call statement 

CALL PFPOLR (R, THETA, BUFX.BUFy, SPECS) 
Description of call list arguments 

R 



THETA 
BUFX 
BUPV 
SPECS 



An array containing the vector lengths of data points to 
be processed. Values are floating-point. 

An array containing the angles, given in radians of data 
points to be processed. Values are floating-point. 

An array of 500io consecutive words provided as a work, 
region for the routine to use to process the data. 

An array of 500io consecutive words provided as a work 
region for the routine to use to process the data. 

An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


* 


Mnemonic 
XDIST 


Parameter 
SPECS 19) 


Mnemonic 


SPECS (J) 




SPECS (2) 


* 


YDIST 


SPECS [10) 




SPECS (3) 


* 


XRIGHT 


SPECS\U) 


TOOL 


SPECS (4) 


* 


XLEFT 


SPECS(U) 


CCTAPE 


SPECS (5) 


* 


YTOP 


SPECS {13) 


POINTS 


SPECS (6) 


* 


YBOT 


SPECS [14) 


XSKIPS 


SPECSI7) 


* 


XLNGTH 


SPECS (15) 


YSKIPS 


SPECS (S) 


A 


YLNGTH 


and 
SPECS [30) 


STAPE 



Data points are defined as follows: The first point is defined 
by the coordinate pair [R(l) ,THETA(1)] ; the next sequential point 
is [R(1+XSKIPS), THETA (1+YSKIPS)], which is followed by [R(1+2XSKIPS) , 
THETA (1+2YSKIPS)], etc. 

Routines Used: POLAR, DATAPE, PFLILI, FAIR, SLLILI, SIGNON.WRGHT. 



The given polar coordinates are not changed. 
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D. Example 



DIMENSION SPECS(30) ,R(25) ,THETA(25) 
DIMENSION BUFX(500),BUFY(500) 

r* c r"T ur\TPT t/nt^T ^ t»i thai h»>* \ 

o oci AUioi,iuiii (in im,nti) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XRIGHT.XLEFT 

SPECS(3) = 100.0 

SPECS(4) = -100.0 
C SET YT0P.YB0T 

SPECS(5) = 100.0 

SPECS(6) = -100.0 
C SET XLNGTH.YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SPECIFY NUMBER OF POINTS 

SPECS(13) = 25. 
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C 
C 



SET XSKIPS.YSKIPS 
SPECS(14) = 1. 
SPECS (15) = 1 . 
SPECIFY SCRATCH FILE NUMBER 
SPECS (30) = 97. 
SETUP SAMPLE R.THETA ARRAYS 
DO 10 1=1,25 
RI = I 

R(D = 5*(I r l) 
THETA(I) = RI/2. 
CONTINUE 

CALL POLAR PARABOLIC FAIRING 
ROUTINE 

CALL PFPOLR(R,THETA,BUFX, 
BUFY .SPECS) 



Reference 
Point 




YBOT 
(6) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Routines to Construct Numerical Values Along an Axis' Scale 



Routine Names 



NODLIB, NODLIT, NODLIL, NODLIR 
NOSLIB, NOSLIT, NOSLIL, NOSLIR 
NOLGB, NOLGT, NOLGL, NOLGR 



Purpose 



There are three sets of routines to construct numerical values along 
an axis' scale. Depending on the suffix letter of the routine 
(B,T,L,R) either the X or Y axis may be labeled. The suffix letters 
B and T denote X-axis annotation of scale values below or above the 
uexineu plotting area. For X-axis annotation the values are parallel 
to the X-axis. The suffix letters L and R denote Y-axis annotation 
of scale values to the left or to the right of the defined plotting 
area. The scale values may be either parallel or perpendicular to 
the Y-axis; SPECS[20) , ROTATE, specifies which layout is desired. 

NODLI This set of routines constructs numerical scale values to a 

specified number of decimal places at regular intervals along 
a linear axis such that the values are oriented next to their 
respective scale lines (centered, if possible about their res- 
pective scale lines). If zero decimal places are specified, 
the decimal point is not drawn. 

NOSLI This set of routines constructs numerical scale values to the 

number of significant figures specified at regular intervals 
along a linear axis such that the values are oriented next to 
their respective scale lines (centered, if possible). 

N0LG_ This set of routines construct numerical scale values along a 
logarithmic (base 10) axis such that the values are oriented 
next to their respective scale lines (centered, if possible). 
The values will be in a form of scientific notation (i.e., 10 N ) 



Method 



In general, all the above routines determine the largest subset of the 
given set of subdivisions such that any two scale values, when con- 
structed, are separated by at least the width of a character. The 
distance between the closest point of the numerical value and the 
defined plotting area is the sum of the appropriate ZONE value and 
(0.25 * Character Size)t. After all construction has occurred, the 
appropriate ZONE value is incremented by the sum of "Greatest Distance 
used in constructing the values" plus (0.25 * Character Size)+. Speci- 
fically, the routines act as follows: 



Character Size is defined to be FONTH for the bottom and top (B,T) 
routines; FONTB for the left and right (L,R) routines. 
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NODLI Explained above. 

NOSLI The maximum absolute value Is rounded and expressed to the 
~~ least significant digit. If necessary, the routine scales 
this value to establish the position of the decimal point. 
For example, if 123.43 is the maximum absolute vulue and 
four significant digits are desired, the routine constructs 
"123.4" and no scaling is required. 

NOTE: If 50.27 is a scale value within the range, the routine 
constructs "50.3". This value Is expressed to one decimal 
place to comply with the format established by the maximum 
absolute value. 

If scaling is necessary, the routine constructs below the 
defined plotting area the phrase "X10 N " where N is the 
appropriate exponent, an integer. 

N0LG_ The routine labels a logarithmic (base 10) scale such that any 
two scale values, when constructed, do not overlap. Although 
some scale values may be omitted to prevent overlap, but less 
than two scale values are constructed. The routine labels 
the logarithmic scale, subject to the above conditions, 
according to the following rules, given in their order of 
application. 

A. If possible, each cycle value (that scale value which 
equals + 10 N ) is labeled "10""" (or "-10 N ") where the 
exponent N is an integer. Only the bottom-most cycle 
value of the scale range is constructed when the scale 
range contains two or more cycle values and no two of 
them can be labeled without overlap. 

B. When all the cycle values of the scale range can be 
constructed or when no cycle value is contained within 
the range, labeling of subcycle values is then attempted. 
One of the following sets of values given in order of 
priority: 

NNNNNNNN 

1. 2x10 , 3x10 , 4x10 , 5x10 , 6x10 , 7x10 , 8x10™, 9x10™ 

N N N N 

2. 2x10 , 4x10™, 6x10 , 8x10 

N N 

3. 2x10™, 5x10™ 

where N is an integer, will be used. If any of the above 
sets can be constructed without overlap, the form of the 
label will be that of the integers only with a negative 
sign if necessary. Otherwise no subcycle values are 
labeled . 

C. If possible or if it is necessary, one or both of the 
minimum and maximum scale values are labeled. Each value 
is scaled to a XI Q N , where 1 <|a|< 10; only the a, 
rounded to two decimal places and including a negative 
sign if necessary, is constructed. 
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D. If a cycle is needed to define the scale range properly, 
the routine will append "X10 N " to either the leftmost 
or rightmost value constructed under rules B or C. 
(This rule covers exceptional cases.) 



Restrictions 



When using the N0LG_ routines the following restriction applies: Both 
the maximum and minimum values of the appropriate data range (X or Y) 
must agree in sign, be non-zero, and be unequal. 

Usage 

See the following individual subroutine writeups for: 

A. FORTRAN call statement 

B. Description of call list arguments 
C Routines Used 

D« Example 
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Subroutine NODLIB 
Purpose 

To construct, to the number of decimal places specified, 
numerical scale values at regular intervals along a linear 
X-axis such that the values are oriented below and parallel to 
the bottom of the defined plotting area. If possible, the scale 
values are centered about their respective scale lines. 



Usage 



A. FORTRAN Call Statement 
CALL NODLIB [SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS m 


* 


XDIST 


SPECS (15) 






SPECS [21 


* 


YDIST 


SPECS (16) 






SPECS (31 


* 


XRIGHT 


SPECS(17) 


* 


FONTB 


SPECS [4) 


* 


XLEFT 


SPECS (1$) 


* 


FONTH 


SPECS (5) 






SPECS (19) 


* 


SPACER 


SPECS (6) 






SPECS (20) 






SPECS (7) 


* 


XLNGTH 


SPECS (21) 


* 


FONTNO 


SPECS (8) 






SPECS (22) 






SPECS (9) 


* 


XDIV 


SPECS (23) 






SPECSdO) 






SPECS (24) 


* 


ZONEB 


SPECS (111 


* 


TOOL 


SPECS (25) 






SPECS (12) 


* 


CCTAPE 


SPECS (26) 






SPECS (13) 






SPECS (27) 






SPECS (14) 






SPECS (28) 


* 


DECPLS 



NOTE: After construction, SPECS (24) is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used: LINLAB, SIGNON, WRGHT 
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D. Example 



C 
C 
C 
C 



DIMENSION SPECS(30) 

SET XDIST.YDIST (IN INCHES) 

i*pif/^r»/T \ _ n nil 
OrtLOV I } - U.O// 

SPECS(2) = 0.877 
SET XRIGHT.XLEFT 
SPECS(3) = 8.0 
SPECS(4) = 
SET XLNGTH 
SPECS(7) = 
SET XDIV 
SPECS (9) = 



2.0 
(IN 
2.5 

4. 



INCHES) 



SPECIFY TOOL (NORMALLY SET TO ONE) 



arcuoj, II I = 



SPECIFY INTERMEDIATE FILE NUMBER 
SPECS02) = 99. 



SPECIFY FONTB, FONTH (INCHES) 
SPECS(17) = 0.1 



orcuo^ io; 



U. i 



C SPECIFY SPACER (IN INCHES) 

SPECS09) = 0.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) =1. 
C SET ZONEB (IN INCHES) 

SPECS(24) = 0.0 
C SPECIFY NUMBER OF DECIMAL PLACES 

SPECS (28) = 1. 

CALL NODLIB (SPECS) 



NOTE; ZONEB is incremented after the construction so that the next 
construction below the defined plotting area will not overlap, 



XLNGTH 



Reference 
Point 




ZONEB Before 
Construction 



SU*— ZONEB After 

•— "I f> 

a:--' Construction 

x 



See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine NODLIT 

Purpose 

To construct, to the number of decimal places specified, 
numerical scale values at regular intervals along a linear X-axis 
such that the values are oriented above and parallel to the top of 
the defined plotting area. If possible, the scale values are 
centered about their respective scale lines. 



Usage 



A. FORTRAN call statement: 
CALL NODLIT (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 




Mnemonic 


SPECS(I) * 


XDIST 


SPECS (15) 






SPECS (2) * 


YDIST 


SPECSi 16) 






SPECS (3) * 


XRIGHT 


SPECS (17) 


* 


FONTB 


SPECS (4) * 


XLEFT 


SPECS(18) 


* 


FONTH 


SPECS (5) 




SPECSi 79) 


* 


SPACER 


SPECS (6) 




SPECS (20) 






SPECS (7) * 


XLNGTH 


SPECS (21) 


* 


FONTNO 


SPECS (&) * 


YLNGTH 


SPECS (22) 






SPECS (9) * 


XDIV 


SPECS (23) 






SPECSHO) 




SPECS (24) 






SPECS (H)* 


TOOL 


SPECS (25) 


* 


ZONET 


SPECSU2)* 


CCTAPE 


SPECS (26) 






SPECS (13) 




SPECS (27) 






SPECS (14) 




SPECS (28) 


* 


DECPLS 



NOTE: After construction, SPECS (251 is incremented so 
that the next construction will not Overlap with 
this construction. 

Routines Used: LINLAB, SIGNON, WRGHT 
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D. Example 





DIMENSION SPECS(30) 


C 


c 


SET XDIST.YDIST (IN INCHES) 
SPECS(l) = 0.877 






SPECS(2) = 0.877 


c 


c 


SET XRIGHT.XLEFT 






SPECS(3) = 8.0 


c 




SPECS(4) = 2.0 




c 


SET XLNGTH.YLNGTH (IN INCHES) 
SPECS(7) = 2.5 


c 




SPECS(8) = 2.5 


c 


c 


SET XDIV 
SPECS(9) = 12. 




c 


SPECIFY TOOL (NORMALLY ONE) 
SPECS(ll) = 1. 




c 


SPECIFY INTERMEDIATE FILE NUMBER 
SPECS(12) = 99. 





SPECIFY FONTB.FONTH (INCHES) 

SPECSH7) = 0.1 

SPECS(18) = 0.1 

SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 

SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 

SET ZONET (IN INCHES) 

SPECS(25) = 0.15 

SPECIFY NUMBER OF DECIMAL PLACES 

SPECS(28) = 1. 

CALL NODLIB (SPECS) 



NOTE; ZONET is incremented after the construction so that the next 

construction above the defined plotting area will not overlap. 




ZONET After 
Construction 

ZONET Before 
Construction 



CD 

_l 
>- 



CO 



Defined Plotting Area 



(/■> 



Q 

>- 



CM 



Reference - 
Point 



XDIST, 



XLNGTH 
~ T77- 



See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine NODLIL 
Purpose 

To construct, to the number of decimal points specified, numer- 
ical scale values at regular intervals along a linear Y-axia such 
that the values are oriented to the left of the defined plotting area, 
If possible, the scale values are centered about their respective 
scale lines. 



Usage 



A. FORTRAN call statement 
CALL NODLIL {SPECS) 



B. Description of call list arguments 



SPECS 



An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


* 


Mnemonic 
XDIST 


Parameter 
SPECS (75) 




Mnemonic 


SPECS ( J) 




SPECS (2) 


* 


YDIST 


SPECS (16) 






SPECS [3) 






SPECS(J7) 


* 


FONTB 


SPECS (41 






SPECS (U) 


* 


FONTH 


SPECS (5) 


* 


YTOP 


SPECS (19) 


* 


SPACER 


SPECS [6] 


* 


YBOT 


SPECS (20) 


* 


ROTATE 


SPECS (7) 






SPECS (2 J) 


* 


FONTNO 


SPECS [8) 


* 


YLNGTH 


SPECS (22) 






SPECS (9) 






SPECS (23) 






SPECS [10] 


* 


YDIV 


SPECS (24) 






SPECS!?/) 


* 


TOOL 


SPECS (25) 






SPECS (12) 


* 


CCTAPE 


SPECSH6) 


* 


ZONEL 


SPECS (13) 






SPECS (27) 






SPECS [14] 






SPECS (28) 


* 


DECPLS 



NOTE: After construction, SPECS (26) is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used: LINLAB, SIGNON, WRGHT 



IV-8.8 



I). Example 



DIMENSION SPECS(30) 
C SET XDIST.YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET YTOP, YBOT 

SPECS(5) = 50.0 

SPECS(6) - 0.0 
C SET YLNGTH (IN INCHES) 

SPECS(8) = 2.5 
C SET YDIV 

SPECS(IO) = 5. 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 



C SPECIFY FONTB, FONTH (INCHES) 

SPECS(17) =0.1 

SPECS(18) = 6.1 
C SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 
C SPECIFY LABEL ORIENTATION 

SPECS(20) = 0.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 
C SET ZONEL (IN INCHES) 

SPECS(26) = 0.0 

f SPFfTFV NIIMRFD OF nFTIMni Dl nrrc 

SPECS(28) = 1. 
CALL NODLIL (SPECS) 



NOTE: ZONEL is incremented after the construction so that the next 
construction to the left of the defined plotting area will 
not overlap. 



— ZONEL After Construction 

— ZONEL Before Construction 



(5) 



YBOT 



' (6) 



I — t 

Q 



»0. 0- 



30.0- 



20.0 



10. 0- 



XDIST 



TT7 




Reference *■ 
Point 

See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine NODLIR 

Purpose 

To construct, to the number of decimal places specified, numer- 
ical scale values at regular intervals along a linear Y-axis such 
that the values are oriented to the right of the defined plotting 
area. If possible, the scale values are centered about their res- 
pective scale lines. 



Usage 



A. FORTRAN call statement 
CALL NODLIR (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS (1) 


* 


XDIST 


SPECS (15) 






SPECS (2) 


* 


YDIST 


SPECS (16) 






SPECS [3) 






SPECS (17) 


* 


FONTB 


SPECS [4] 






SPECS(U) 


* 


FONTH 


SPECS (5) 


* 


YTOP 


SPECS! 19) 


* 


SPACER 


SPECS [6) 


* 


YBOT 


SPECS (20) 


* 


ROTATE 


SPECS {7) 


* 


XLNGTH 


SPECS(21) 


* 


FONTNO 


SPECS («) 


* 


YLNGTH 


SPECS (22) 






SPECS [9) 






SPECS (23) 






SPECS (10) 


* 


YDIV 


SPECS (24) 






SPECS (11) 


* 


TOOL 


SPECS ( 25) 






SPECS (12) 


* 


CCTAPE 


SPECS (26) 






SPECS (13) 






SPECS (27) 


* 


ZONER 


SPECS (14) 






SPECS (2 S) 


* 


DECPLS 



NOTE: After construction, SPECS (271 is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used: LINLAB, SIGNON, WRGHT 
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D. Example 





DIMENSION SPECS (30) 


C 


c 


SET XDIST, YDIST (IN INCHES) 
SPECS(l) = 0.877 






SPECSC2) = 0.877 


C 


c 


SET YTOP, YBOT 






SPECS(5) = 50.0 


C 




SPECS(6) = 0.0 




c 


SET XLNGTH, YLNGTH (IN INCHES) 
SPECS(7) = 2.5 


C 




SPECS(8) = 2.5 


C 


c 


SET YDIV 






SPECS(IO) = 20. 


C 


c 


SPECIFY TOOL (NORMALLY ONE) 
SPECS(ll) = 1. 




c 


SPECIFY INTERMEDIATE FILE NUMBER 
SPECS(12) = 99. 





SPECIFY FONTB,FONTH (INCHES) 

SPECS(17) = 0.1 

SPECS(18) = 0.1 

SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 

SPECIFY LABEL ORIENTATION 

SPECS(20) = 90.0 

SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS (21) = 1. 

SET ZONER (IN INCHES) 

SPECS(27) = 0.3 

SPECIFY NUMBER OF DECIMAL PLACES 

SPECS(28) = 1. 

CALL NODLIR (SPECS) 



NOTE: ZONER is incremented after the construction so that the next 
construction to the right of the defined plotting area will 
not overlap. 



ZONER After Construction 
ZONER Before Construction 



z 
_ 
>- 



tn 



>- 



CO 



Reference * - X ?|F - 



Defined Plotting Area 



XLNGTH 



(7) 




Point 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine NOSLIB 



Purpose 



To construct, to the number of significant figures specified, 
numerical scale values at regular intervals along a linear X-axis 
such that the values are oriented below and parallel to the bottom 
of the defined plotting area. If possible, the scale values are 
centered about their respective scale lines. 



Usage 



A. FORTRAN call statement 
CALL NOSLIB [SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS (1) 


* 


XDIST 


SPECS [16] 






SPECS (2) 


* 


YDIST 


SPECS [17] 


* 


FONTB 


SPECS (3) 


* 


XRIGHT 


SPECS (?«) 


* 


FONTH 


SPECS (4) 


* 


XLEFT 


SPECS (1 91 


* 


SPACER 


SPECS (5) 






SPECS (20) 




FONTNO 


SPECS (6) 






SPECS (21) 


* 


SPECS (7J 


* 


XLNGTH 


SPECS (22) 






SPECS (*) 






SPECS[23) 






SPECS (9) 


* 


XDIV 


SPECS{24) 


* 


ZONEB 


SPECS [10\ 






SPECS (25) 






SPECS(n) 


* 


TOOL 


SPECS[26) 






SPECS (12) 


* 


CCTAPE 


SPECS (27) 






SPECS (13) 






SPECS (28) 






SPECS (141 






SPECS (29) 


* 


SIGFIG 


SPECS (1 5) 













NOTE: After construction, SPECS (24) is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used: SIGDEC, SIGNON, WRGHT 
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D. Example 





DIMENSION SPECS(30) 


C 


c 


SET XDIST, YDIST (IN INCHES) 
SPECS(l) = 0.877 






SPECS (2) = 0.877 


C 


c 


SET XRIGHT, XLEFT 






SPECS(3) = 10000.U 


C 




SPECS(4) = 0.0 




c 


SET XLNGTH (IN INCHES) 
SPECS(7) = 2.5 


C 


c 


SET XDIV 


C 




SPECS(9) = 4. 


C 


c 


SPECIFY TOOL (NORMALLY ONE) 
SPECS(ll) = 1. 




c 


SPECIFY INTERMEDIATE FILE NUMBER 
SPECS(12) = 99. 





SPECIFY FONTB.FONTH (INCHES) 

SPECS(17) = 0.1 

SPECS(18) = 0.1 

SPECIFY SPACER (IN INCHES) 

SPECS(19) - 0.0 

SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 

SET ZONEB (IN INCHES) 

SPECS(24) = 0.0 

SPECIFY NUMBER OF SIGNIFICANT 

FIGURES 

SPECS(29) = 4. 

CALL NOSLIB (SPECS) 



NOTE: ZONEB is incremented after the construction so that the next 
construction below the defined plotting area will not overlap. 



XLNGTH 



(7) 



Defined Plotting Area 



>■ 



Reference L X ?^ T - 
Point u ' 




Lr 



ZONEB Before Construction 



750 1000 



cjL-v 
i— I'ro 

C£. — 
X 



ZONEB After Construction 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine NOSLIT 



Purpose 



To construct, to the number of significant figures specified, 
numerical scale values at regular intervals along a linear X-axis 
such that the values are oriented above and parallel to the top 
of the defined plotting area. If possible, the scale values are 
centered about their respective scale lines. 



Usage 



A. FORTRAN call statement 
CALL NOSLIT {SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS (71 


* 


XDIST 


SPECS (76) 






SPECS (2) 


* 


YDIST 


SPECS (7 7) 


* 


FONTB 


SPECS (31 


* 


XRIGHT 


SPECS [18) 


* 


FONTH 


SPECS {4) 


* 


XLEFT 


SPECS (1 9) 


* 


SPACER 


SPECS (5) 






SPECS (20) 






SPECS (6) 






SPECS (27) 


* 


FONTNO 


SPECS [7 \ 


* 


XLNGTH 


SPECS (22) 






SPECS (SI 


* 


YLNGTH 


SPECS (23) 






SPECS (9) 


* 


XDIV 


SPECS (24) 






SPECS (701 






SPECS (25) 


* 


ZONET 


SPECS (77} 


* 


TOOL 


SPECS (26) 






SPECS (72) 


* 


CCTAPE 


SPECS (27) 






SPECS (1 3) 






SPECS [28] 






SPECS (74) 






SPECS (29) 


* 


SIGFIG 


SPECS (75) 













NOTE: After construction, SPECS (25) is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used: SIGDEC, SIGNON, WRGHT 
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Example 





DIMENSION SPECS(30) 


C 


SPECIFY FONTB.FONTH (INCHES) 


c 


SET XDIST, YDIST (IN INCHES) 




SPECS(17) = 0.1 




SPECS(l) = 0.877 




SPECS(18) = 0.1 




SPECS(2) = 0.877 


C 


SPECIFY SPACER (IN INCHES) 


c 


SET XRIGHT, XLEFT 




SPECS(19) = 0.0 




SPECS(3) = 0.0001234 


C 


SPECIFY FONT TYPE (NORMALLY ONE) 




SPECS(4) = 0.0000333 




SPECS(21) = 1. 


c 


SET XLNGTH (IN INCHES) 


C 


SET ZONET (IN INCHES) 




SPECS(7) = 2.5 




SPECS(25) = 0.3 


c 


SET XDIV 


C 


SPECIFY NUMBER OF SIGNIFICANT 




SPECS(9) = 12. 


C 


FIGURES 


c 


SPECIFY TOOL (NORMALLY ONE) 




SPECS(29) = 4. 




SPECS(ll) = 1. 




CALL NOSLIT (SPECS) 


c 


SPECIFY INTERMEDIATE FILE NUMBER 
SPECS(12) = 99. 




; 



NOTE: ZONET is incremented after the construction so that the next 
construction above the defined plotting area will not overlap, 




:r 



Xl p—ZONET After 
\ *^ t«J Construction 



t — i 1 — i — i — r^ 



PHCVIOUS CONSTRUCTION 



L; 



CJ3 

■z. 

_J 
>- 



oo 






Reference 
Point 



CO 



ZONET Before 
Construction 



Defined Plotting Area 



C\J 



XDIST 



XI NfiTH 



(7) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine NQSLIL 
Purpose 

To construct numerical scale values, to the number of significant 
figures specified, at regular intervals along a linear Y-axis 
such that the values are oriented to the left of the defined plotting 
area. If possible, scale values are centered about their respective 
scale lines. 



Usage 



A. FORTRAN call statement 
CALL NOSLIL {SPECS) 

B. Description of call list arguments 



SPECS 



An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS [ 1 ) 


* 


XDIST 


SPECS (16) 






SPECS [2) 


* 


YDIST 


SPECS(J7) 


* 


FONTB 


SPECS (3) 






SPECS (U) 


* 


FONTH 


SPECS [4) 






SPECS [19) 


* 


SPACER 


SPECS (5) 


* 


YTOP 


SPECS (20) 


* 


ROTATE 


SPECS (61 


* 


YBOT 


SPECS (21) 


* 


FONTNO 


SPECS [7) 






SPECS (22) 






SPECS (S) 


* 


YLNGTH 


SPECS (23) 






SPECS! 9) 






SPECS (24) 






SPECS! JO) 


* 


YDIV 


SPECS (25) 






SPECS ( 11 ) 


* 


TOOL 


SPECS (26) 


* 


ZONEL 


SPECS [U] 


* 


CCTAPE 


SPECS (27) 






SPECS (13) 






SPECS (2 S) 






SPECS (U) 






SPECS (29) 


* 


SIGFIG 


SPECS (15) 













NOTE: After construction, SPECS(26) is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used; SIGDEC, SIGNON, WRGHT 
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D. Example 





DIMENSION SPECS(30) 


c 


sft xnrsT. ydtst riN rNr.nF<n 




SPECS(l) = 0.877 




SPECS(2) = 0.877 


c 


SET YTOP, YBOT 




SPECS(5) = 526000 




SPECS(6) = 3000 


c 


SET YDIV 




SPECS(IO) = 10. 


c 


SPECIFY TOOL (NORMALLY ONE) 


r 


SPECS(ll) = 1. 

SPFTTFV TMTCDMmTflTr CTI C Mil 



SPECS(12) = 99. 



C SPECIFY FONTB, FONTH (INCHES) 

SPECS (17) =0.1 

SPECS (18) = o!l 
C SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 
C SPECIFY LABEL ORIENTATION 

SPECS(20) = 0.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 
C SET ZONEL 

SPECS(26) = 0.0 
o orhoin iiuMdck ur MlaNlhlLAN I 

C FIGURES 

SPECS(29) = 4. 

CALL NOSLIL (SPECS) 



NOTE: ZONEL is incremented after the construction so that the next con- 
struction to the left of the defined plotting area will not overlap. 



YDIV 
(10) 




ZONEL After Construction 
ZONEL Before Construction 



Reference L XD IST_ 



Point 



Defined Plotting Area 



z 
_ 
>- 



00 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine NOSLIR 
Purpose 

To construct, to the number of significant figures specified, 
numerical scale values at regular intervals along a linear Y-axis 
such that the values are oriented to the right of the defined plotting 
area. If possible, the scale values are centered about their res- 
pective lines. 



Usage 



A. FORTRAN call statement 
CALL NOSLIR {SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 




Mnemonic 


SPECS(7) * 


XDIST 


SPECS [16) 






SPECS 12) * 


YDIST 


SPECS (17) 


* 


FONTB 


SPECS (3) 




SPECS (IS) 


* 


FONTH 


SPECS [4) 




SPECS (J 9) 


* 


SPACER 


SPECS (5) * 


YTOP 


SPECS (20) 


* 


ROTATE 


SPECS [6 ) * 


YBOT 


SPECS(27) 


* 


FONTNO 


SPECS (7) * 


XLNGTH 


SPECS (22) 






SPECS [8) * 


YLNGTH 


SPECS (23) 






SPECS (9) 




SPECS (24) 






SPECS (70)* 


YDIV 


SPECS (25) 






SPECS(U)* 


TOOL 


SPECS [26) 






SPECS ( T 2 J * 


CCTAPE 


SPECS (27) 


* 


ZONER 


SPECS (7 3) 




SPECS (2*) 






SPECS (74) 




SPECS (29) 


* 


SIGFIG 


SPECS (15) 











NOTE: After construction, SPECS(27) is incremented so 
that the next construction will not overlap with 
this construction. 

C. Routines Used: SIGDEC, SIGNON, WRGHT 
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D. Example 



C 
C 
C 



DIMENSION SPECS(30) C 

SET XDIST, YDIST (IN INCHES) 

SPLCS(l) = 0.8// 

SPECS(2) = 0.877 C 

SET YTOP, YBOT 

SPECS (5) = 526000 C 

SPECS (6) = 3000 

SET XLNGTH, YLNGTH (IN INCHES) C 

SPECS(7) =2.5 

SPECS(8) = 2.5 C 

SET YDIV 

SPECS(IO) = 15. C 

SPECIFY TOOL (NORMALLY ONE) 

SPECSM1) = 1. 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 



SPECIFY FONTB, FONTH (INCHES) 

SPECS(17) = 0.1 

SPECS(18) = 0.1 

SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 

SPECIFY LABEL ORIENTATION 

SPECS(20) = 90.0 

SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 

SET ZONER (IN INCHES) 

SPECS(27) = 0.3 

SPECIFY NUMBER OF SIGNIFICANT FIGURES 

SPECS(29) = 4. 

CALL NOSLIR (SPECS) 



NOTE; ZONER is incremented after the construction so that the next 
construction to the right of the defined plotting area will 
not overlap. 



ZONER After Construction 
ZONER Before Construction 



cr 

z 
_j 
>■ 



>- 



00 



CM 



Reference >- X 9. I ? T 
Point UJ 



Defined Plotting Area 



XI NfiTH 




(7) 



YDIV 
(10) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine NOLGB 
Purpose 

To construct numerical scale values along a logarithmic (base 10) 
X-axis such that the values are oriented below and parallel to the 
bottom of the defined plotting area. The values will be in a form 
of scientific notation. 



Usag e 



A. FORTRAN call statement 
CALL NOLGB (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS (1) 


* 


XDIST 


SPECS (1 3) 




SPECS (2) 


* 


YDIST 


SPECS (14) 




SPECS (3) 


* 


XRIGHT 


SPECS ( 15) 




SPECS (4) 


* 


XLEFT 


SPECS (16) 




SPECS (5) 






SPECS! J 7) * 


FONTB 


SPECS (6 J 






SPECS (18) * 


FONTH 


SPECS (7) 


* 


XLNGTH 


SPECSi 19) * 


SPACER 


SPECS (I J 






SPECS (20) 




SPECS (9) 






SPECS(ZI) * 


FONTNO 


SPECS (10) 






SPECS (22) 




SPECS(11) 


* 


TOOL 


SPECS (23) 




SPECS (12) 


* 


CCTAPE 


SPECS (24) * 


ZONEB 



NOTE: After construction, SPECS (24) is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used: LOGLAB, SIGNON, WRGHT 
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D. Example 



C 
C 



DIMENSION SPECS(30) 

SET XDIST, YDIST (IN INCHES) 

SPECS(T) = 0.877 

SPECS(2) = 0.877 

SET XRIGHT, XLEFT 

SPECS(3) = 100.0 

SPECS(4) = 10.0 

SET XLNGTH 

SPECS(7) = 2.5 

SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 

SDFPTFV TNTFRMFnTflTF FTI F NIIMRFR 

SPECS(12) = 99. 



C SPECIFY FONTB.FONTH (INCHES) 

SPECSH7) = 0.1 

SPECS(18) = 0.1 
C SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21 ) = 1 . 
C SPECIFY Z0NEB*(IN INCHES) 

SPECS(24) = 0.0 

CALL NOLGB (SPECS) 



NOTE; ZONEB is incremented after the construction so that the next 

construction below the defined plotting area will not overlap. 



XLNGTH 



Reference 
Point 




ZONEB Before 

J Construction 



=M — ZONEB After 

3°° Construction 

cc — * 

x 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine NOLGT 
Purpose 

To construct numerical scale values along a logarithmic (base 10) 
X-axis such that the values are oriented above and parallel to the 
top of the defined plotting area. The values will be in a form of 
scientific notation. 



Usage 



A. FORTRAN call statement 
CALL NOLGT {SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters 'indicated 
below by an * to be specified prior to calling -it: 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS(J) 


* 


XDIST 


SPECS { 14) 




SPECS (2 J 


* 


YDIST 


SPECS [15) 




SPECS [3) 


* 


XRIGHT 


SPECS[16) 




SPECS [4) 


* 


XLEFT 


SPECS[17) * 


FONTB 


SPECS (5 J 






SPECSI/8) * 


FONTH 


SPECS (6) 






SPECSU9) * 


SPACER 


SPECS (7) 


* 


XLNGTH 


SPECS [20) 




SPECS (*) 


* 


YLNGTH 


SPECS[21) * 


FONTNO 


SPECS (9) 






SPECS (22) 




SPECS [10) 






SPECS (23) 




SPECS [11) 


* 


TOOL 


SPECS [24) 




SPECS { 12) 


* 


CCTAPE 


SPECS (25) * 


ZONET 


SPECS (J 3) 











NOTE: After construction, SPECS (25) is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used: LOGLAB, SIGNON, WRGHT 
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D. Example 



C 

C 

C 
C 



DIMENSION SPECS(30) 

3ti AUiii , iinoi (in in^nca; 

SPECS(l) = 0.877 

SPECS(2) = 0.877 

SET XRIGHT, XLEFT 

SPECS(3) = 80.0 

SPECS(4) = 2.0 

SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 

SPECIFY TOOL (NORMALLY ONE) 

SPECS(11 ) = 1 . 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 



C SPECIFY F0NTB.F0NTH (IN INCHES) 

rrtr^r 1 1 -? \ _ r» t 
irLLOV. • I \ ~ U.I 

SPECS(18) = 0.1 
C SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21 ) = 1 . 
C SPECIFY Z0NET'(IN INCHES) 

SPECS(25) = 0.3 

CALL NOLGT (SPECS) 



NOTE; ZONET is incremented after the construction so that the next 

construction above the defined plotting area will not overlap. 



t 



CD- 



5 1 

i — i i i i 1 1 



1 



gp ZONET After 
II Construction 



C£ 



IS) 



Q 

>- 



Reference 
Point 



CO 



CM 



XDIST 



(1) 



~i — i — i i 1 1 1 1 i — i i i i 1 1 1 

PREVl OUS CONSTRUCT I ON 



*1_ 



Defined Plotting Area 



XLNGTH 



(7) 



ZONET Before 
Construction 



See the appropriate post-processor writeup fcr the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine NOLGL 



Purpose 



To construct numerical scale values along a logarithmic (base 10) 
Y-axis such that the values are oriented to the left of the defined 
plotting area. The values will he in a form of scientific notation. 



Usage 



A. FORTRAN call statement 
CALL NOLGL (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 


Mnemonic 


SPECS (7) * 


XDIST 


SPECS (14) 




SPECS (2) * 


YDIST 


SPECS (15) 




SPECS (3) 




SPECS (16) 




SPECS (4) 




SPECS (17) * 


FONTB 


SPECS (5) * 


YTOP 


SPECS (IS) * 


FONTH 


SPECS {6) * 


YBOT 


SPECS(I9) * 


SPACER 


SPECS [7) 




SPECS (20) * 


ROTATE 


SPECS (8) * 


YLNGTH 


SPECS (2J) * 


FONTNO 


SPECS (9) 




SPECS (22) 




SPECS (10) 




SPECS (23) 




SPECS(N)* 


TOOL 


SPECS (24) 




SPECSU21* 


CCTAPE 


SPECS (25) 




SPECS (13) 




SPECS (26) * 


ZONEL 



NOTE: After construction, SPECS (26) is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used; LOGLAB, SIGNON, WRGHT 
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Example 



DIMENSION SPECS(3) 



CCT 



VHTCT 

AU1J I , 



vnrcT 



.'mi 



= 0.877 
= 0.877 
YBOT 
= 4000.0 
= 28.0 

INCHES) 



rurucc \ 



SPECS(l) 

SPECS (2) 
C SET YTOP. 

SPECS(5) 

SPECS(6) 
C SET YLNGTH (IN 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 



onr/"* t r-\/ 

orLurr 



lm cRMluihi t 



FILE NUMBER 



SPECS(12) = 99. 



SPECIFY F0NTB.F0NTH (INCHES) 



fnrrr /ill 

orcv.o^ i / j 






SPECS(18) = 0.1 
C SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 
C SPECIFY LABEL ORIENTATION 

SPECS(20) = 90.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) =1. 

CALL N0LGL (SPECS) 



NOTE: ZONEL is incremented after the construction so that the next 

construction to the left of the defined plotting area will not 
overlap . 



HQEjSt 



(5) * 



ZONEL After Construction 
ZONEL Before Construction 



a 



in 



CM 

a 



\n 



(6) 



w, 



>- 



YROT L 



CM 



Reference *- ty\\ J -\ 
Point [l) 




See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine NOLGR 



Purpose 



To construct numerical scale values along a logarithmic (base 10) 
Y-axis such that the values are oriented to the right of the defined 
plotting area. The values will be in a form of scientific notation. 



Usage 



A. FORTRAN call statement 
CALL NOLGR (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it;: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS! I) 


* 


XDIST 


SPECS (15) 






SPECS (21 


* 


YDIST 


SPECS (16) 






SPECS (3) 






SPECS (17) 


* 


FONTB 


SPECS (4) 






SPECS (1&) 


* 


FONTH 


SPECS (5 J 


* 


YTOP 


SPECS ( 19) 


* 


SPACER 


SPECS (61 


* 


YBOT 


SPECS (20) 


* 


ROTATE 


SPECS (71 


* 


XLNGTH 


SPECS (21) 


* 


FONTNO 


SPECS (8) 


* 


YLNGTH 


SPECS (22) 






SPECS (9) 






SPECS (23) 






SPECS [10) 






SPECS (24) 






SPECS(11) 


* 


TOOL 


SPECS (25) 






SPECS(12) 


* 


CCTAPE 


SPECS (26) 






SPECS (13) 






SPECS (271 


* 


ZONER 


SPECS(U) 













NOTE: After construction, SPECS (27) is incremented so 
that the next construction will not overlap with 
this construction. 

Routines Used: LOGLAB, SIGNON, WRGHT 
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D. Example 



DIMENSION SPECS(30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS (2) = 0.877 
C SET YTOP, YBOT 

SPECS(5) = 61.2 

SPECS(6) = 40.0 
C SET XLNGTH, YINGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS (8) =2.5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1.' 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 



C SPECIFY FONTB. FONTH (INCHES) 

SPECS(17) =0.1 

SPECS(18) = 0.1 
C SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 
C SPECIFY LABEL ORIENTATION 

SPECS(20) = 90.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 
C SPECIFY ZONER (IN INCHES) 

SPECS(27) =0.3 

CALL NOLGR (SPECS) 



NOTE: ZONER is incremented after the construction so that the next 
construction to the right of the defined plotting area will 
not overlap. 



ZONER After Construction 
ZONER Before Construction 



ta 



CO 



Defined Plotting Area 



7= 

J in 



YTOP 
(5) 



c/> 



Q 



Reference 
Point 



CM 



XDIST 



XLNGTH 



TtT 



YBOT 
(6) 



(1) 

See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Routines to Construct Centered Alphanumeric Titles 

Routine Names 

TITLEB, TITLET, TITLEL, TITLER 
Purpose 

To construct one or more lines of text to be centered below, above, 

^^ f-Vio loft- e\f t- r\ t- h o *"-|r7ht- nf t~ha Aaf-inaA nlnM"-ino ar*oa A ananrl ^ r\n 

t_W Will- -kV... t- , W ». WW W.4W *.^. & »«W W*. W..W I.W.. .^..WW. ^^WW..^..^ W.A. WU «*«.£,«.. «W..k..£ 

on the suffix letter (B,T,L,R) of the subroutine called. 

Method 

For a single line of text : 

To construct a single line of text, the routine computes the length 
of the line in order to center it about the defined plotting area. 
The line of text is spaced away from the defined plotting area by 
the distance which is computed by adding the appropriate ZONE value 
plus (0.25 * Character Size). Character Size is defined to be either 
FONTH or FONTB depending on whether a horizontal (TITLEB, TITLET) or 
a vertical (TITLEL, TITLER) titling routine is called. After the 
line of text has been constructed the appropriate ZONE value is 
incremented by (1.5 * Character Size). 

For multiple lines of text : 

To construct more than one line of text, the routines basically 
repeat the above computation for each additional line. Since the 
ZONE value is incremented, consecutive lines of text are separated 
by one-half the Character Size. TITLEB and TITLER process the con- 
secutive lines of text in normal order given with the first line of 
text closest to the defined plotting area. TITLET and TITLEL pro- 
cess the consecutive lines of text in reverse order with the last 
line of text closest to the defined plotting area. 

Restrictions 

A. Text: A line of text cannot exceed 1060 alphanumeric characters. 

B. Character Size: See appropriate post-processor writeup for any 

restrictions on the character size. 

Usage 

See the following individual subroutine writeups for: 

A. FORTRAN call statement 

B. Description of call list arguments 

C. Routines Used 

D. Example 
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Subroutine TITLEB 



Purpose 



To construct one or more lines of text to be centered below and 
parallel to the top of the defined plotting area. 



Usage 



A. FORTRAN call statement 

For single line of text use 

CALL TITLEB (#H. .., SPECS) 

or 
CALL TITLEB (LINE, SPECS) 

For multiple lines of text use 

CALL TITLEB (#H. . ,#H. .,.. ,#H. ., SPECS) 
B. Description of call list arguments 



#H. 



Array containing alphanumeric text. It is usually implied 
by Hollerith literals. The Hollerith literal may be simu- 
lated by using an array LINE with the following format: 



Location 

LINE(l) 
LINE (2) 
LINE (3) 
LINE (4) 



Contents 

THISblSbSA 

MPLEbLINEb 

OFbTEXT.bb 





SPECS 



where b represents a space. The last word (in this 
example LINE(4)) is set to an integer zero to signify the 
end of the line of text. 

An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format . This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 


Mnemonic 


SPECS! J) * 


XDIST 


SPECS! J 3) 




SPECS (2) * 


YDIST 


SPECS ( 14) 




SPECS (3) 




SPECS { 15) 




SPECS [4) 




SPECS (16) 




SPECS (5) 




SPECS( 17) * 


FONTB 


SPECS (6) 




SPECS(1S) * 


FONTH 


SPECS (7) * 


XLNGTH 


SPECSIJ9) * 


SPACER 


SPECS (Z) 




SPECS (20) 




SPECS (9) 




SPECS(21) * 


FONTNO 


SPECS(IO) 




SPECS (22) 




SPECS [11]* 


TOOL 


SPECS (23) 




SPECS (12)* 


CCTAPE 


SPECS (24) * 


ZONEB 
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c. 

D, 



Routines Used: TITLED, TITLEG, SIGNON, WRGHT 
Example 

DIMENSION SPECSC30) 
C SET XDIST.YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XLNGTH (IN INCHES) 

SPECS(7) = 2.5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SPECIFY FONTB.FONTH (INCHES) 

SPECS(17) = 0.1 

SPECS(18) = 0.1 
C SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21 ) = 1 . 
C SET ZONEB ( IN ' INCHES) 

SPECS(24) = 0.1 

CALL TITLEB02HBOTTOM TITLE, SPECS) 



XLNGTH 



Reference 
Point 




ZONEB Before 

Construction 

ZONEB After 

Construction 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine TITLET 



Purpose 



To construct one or more lines of text to be centered above and 
parallel to the top of the defined plotting area. 



Usage 



A. FORTRAN call statement 

For a single line of text use 

CALL TITLET (#h. .., SPECS) 

or 
CALL TITLET UWE,SPECS J 

For multiple lines of text use 

CALL TITLET (#h..,*h. .,..,%.., SPECS) 

B. Description of call list arguments 



*H.. 



Array containing alphanumeric text. It is usually implied 
by Hollerith literals. The Hollerith literal may be simu- 
lated by using an array LINE with the following format: 



Location 

LINE(l) 
LINE (2) 
LINE (3) 
LINE (4) 



Contents 

THISblSbSA 

MPLEbLINEb 

OFbTEXT.bb 





where b represents a space. The last word (in this 
example LINE (4)) is set to an integer zero to signify the 
end of the line of text. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 


Mnemonic 


SPECS (I) 


* 


XDIST 


SPECS [14) 




SPECS {2) 


* 


YDIST 


SPECS [15) 




SPECS (3) 






SPECS [16) 




SPECS [4) 






SPECS! J 7) * 


FONTB 


SPECS (5) 






SPECS[ 1 S) * 


FONTH 


SPECS {6) 






SPECS (J 9) * 


SPACER 


SPECS (7) 


* 


XLNGTH 


SPECS [20) 




SPECS [8] 


* 


YLNGTH 


SPECS[21) * 


FONTNO 


SPECS {9) 






SPECS [22) 




SPECS [10) 






SPECS (23) 




SPECS[11) 


* 


TOOL 


SPECS [24) 




SPECS (12) 


* 


CCTAPE 


SPECS (25) * 


ZONET 


SPECS [13) 
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C. Routines Used: TITLED, TITLEG, SIGNON, WRGHT 

D . Example 

DIMENSION SPECS(30) 
C SET XDIST.YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XLNGTH.YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8) = 2.5 
C SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SPECIFY FONTB, F0NTH( INCHES) 

SPECS(17) = 0.1 

SPECS(18) = 0.1 
C SPECIFY SPACER (IN INCHES) 

sPECs(ig) = o.o 

C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 
C SET ZONET (IN INCHES) 

SPECS(25) = 0.0 

CALL TITLET(9HT0P TITLE.SPECS) 



Reference 
Point 





TOP TITLE 




, 




Defined Plotting Area 


'[ 


3T 
1— 
CD 

_J 
>- 


00 
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C\J 


XLNGTH 




i — t 

Q 

>- 


(7) 






XDIST 








(1) 







L 



ZONET After 
Construction 

ZONET Before 
Construction 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine TITLEL 



Purpose 



To construct one or more lines of text to be centered left of and 
parallel to the left side of the defined plotting area. 



Usage 



A. FORTRAN call statement 

For a single line of text use 

CALL TITLEL(#H..., SPECS) 

or 
CALL TITLEL (LINE,SPECS) 

For multiple lines of text use 

CALL TITLEL (#H. .,*H. .,..,%.., SPECS) 

B. Description of call list arguments 



m.. 



Array containing alphanumeric text. It is usually implied 
by Hollerith literals. The Hollerith literal may be simu- 
lated by using an array LINE with the following format: 



Location 

LINE(l) 
LINE (2) 
LINE (3) 
LINE (4) 



Contents 

THISblSbSA 

MPLEbLINEb 

OFbTEXT.bb 





SPECS 



where b represents a space. The last word (in this 
example LINE (4)) is set to an integer zero to signify the 
end of the line of text. 

An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 


Mnemonic 


SPECS ( 1 ) * 


XDIST 


SPECS [14) 




SPECS ( 2 ) * 


YDIST 


SPECS (J 5) 




SPECS (3) 




SPECS (16) 




SPECS (4) 




SPECS(17) * 


FONTB 


SPECS (5) 




SPECS (1 8) * 


FONTH 


SPECS [6) 




SPECS! 19) * 


SPACER 


SPECS (7) 




SPECS (20) 




SPECS (8) * 


YLNGTH 


SPECSI21) * 


FONTNO 


SPECS (9) 




SPECS (22) 




SPECS [ 10) 




SPECS [23) 




SPECS[11) * 


TOOL 


SPECS (24) 




SPECS! 12) * 


CCTAPE 


SPECS (25) 




SPECS (7 3) 




SPECS (26) * 


ZONEL 
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C. Routines Used: TITLED, TITLEG, SIGNON, WRGHT 

D. Example 

DIMENSION SPECS(30), LINE(2) 

DATA LINE(1)/10HLEFT TITLE/0 

DATA LINE(2)/0/ 
C SET XDIST.YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET YLNGTH (IN INCHES) 

SPECS(8) = 2.5 
C SPECIFY TOOL* (NORMALLY ONE) 

SPECS M i \ - l 
C SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 
C SPECIFY FONTB.FONTH (INCHES) 

SPECS(17) = 0.1 

SPECS(18) = 0.1 
C SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 
C SET ZONEL (IN INCHES) 

SPECS(26) = 0.0 

CALL TITLEL(LINE, SPECS) 



ZONEL After Construction 



, ZONEL Before Construction 




Reference * * X ?]^ T 
Point u; 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 



IV-9 . 7 



Subroutine TITLER 



Purpose 



To construct one or more lines of text to be centered to the right of 
and parallel to the right side of the defined plotting area. 



Usage 



A. FORTRAN call statement 

For a single line of text use 

CALL TITLER (#h... ,SPECS) 

or 
CALL TITLER CLINE,SPECS) 

For multiple lines of text use 

CALL TITLER (#R. .,*H. .,. .,#H. ., SPECS) 

B. Description of call list arguments 



#H. 



Array containing alphanumeric text. It is usually implied 
by Hollerith literals. The Hollerith literal may be simu- 
lated by using an array LINE with the following format: 



Location 

LINE(l) 
LINE (2) 
LINE (3) 
LINE (4) 



Content 

THISblSbSA 

MPLEbLINEb 

OFbTEXT.bb 





where b represents a space. The last word (in this 
example LINE(4)) is set to an integer zero to signify the 
end of the line of text. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 




Mnemonic 


Parameter 




Mnemonic 


SPECS { 1) 


* 


XDIST 


SPECS(J5) 






SPECS (2) 


* 


YDIST 


SPECS (16) 






SPECS (3) 






SPECS(J7) 


* 


FONTB 


SPECS [4) 






SPECS (IS) 


* 


FONTH 


SPECS (5) 






SPECS (7 9) 


* 


SPACER 


SPECS (6) 






SPECS (20) 






SPECS (7) 


* 


XLNGTH 


SPECS (21) 


* 


FONTNO 


SPECS (S) 


* 


YLNGTH 


SPECS (22) 






SPECS [9) 






SPECS (23) 






SPECSUO) 






SPECS {24) 






SPECS ( n ) 


* 


TOOL 


SPECS (25) 






SPECS (12) 


* 


CCTAPE 


SPECS (26) 






SPECS {1 3) 






SPECS (27) 


* 


ZONER 


SPECS ( 14) 
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c. 

D. 



Routines Used: TITLED, TITLEG, SIGNON, WRGHT 
Example 

DIMENSION SPECS(30) 
C SET XDIST, YDIST (IN INCHES) 

SPECS(l) = 0.877 

SPECS(2) = 0.877 
C SET XLNGTH, YLNGTH (IN INCHES) 

SPECS(7) = 2.5 

SPECS(8} =25 
C SPECIFY TOOL* (NORMALLY ONE) 

SPECS(ll) = 1. 

r CDCTTCV tmTcnurriTiiTr rn r ununrn 

o jrn,iri hi i cKntuin 1 1 riLC iiuPIdck 

SPECS(12) = 99. 
C SPECIFY FONTB, FONTH (INCHES) 

SPECS(17) = 0.1 

SPECS08) = 0.1 
C SPECIFY SPACER (IN INCHES) 

SPECS(19) = 0.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 
C SET ZONER (IN INCHES) 

SPECS(27) = 0.0 

CALL TITLER (11HRIGHT TITLE.SPECS) 



ZONER After Construction 
ZONER Before Construction 



in 



00 



>- 



3 



Defined Plotting Area 



XI NfiTH 



Reference L — W£L 
Point [l > 



(7) 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine TITLEG 

Purpose 

To construct a single line of text above an arbitrary reference line. 

Method 

The routine constructs the line of text immediately above the 
reference line. The X ordinate (inches) of a specified point 
on the line (left, center, right) is SPECS (22). The Y ordinate 
is SPECS(23). SPECS(20| specifies the rotation angle (degrees) of 
the reference line with respect to the horizontal. 

Restrictions 

A line of text cannot exceed 1060 alphanumeric characters. 

Usage 

A. FORTRAN call statement 

CALL TITLEG (RULE, *H. .., SPECS) 

or 
CALL TITLEG (RULE, LIME, SPECS) 

B. Description of call list arguments 

RULE A floating-point variable which specifies which point on 
the line(s) of text is used with XSTART and YSTART for 
positioning the line. RULE may either be 1., 2., or 3. 
according to the following table: 

RULE = 1. The specified point on the line of text is 

the lower left corner of the first character. 

RULE = 2. The specified point is at the lower center 
of the line of text. 

RULE ■ 3. The specified point on the line of text is 

the lower right corner of the last character. 

#H... Array containing alphanumeric text. It is usually implied 
by Hollerith literals. The Hollerith literal may be simu- 
lated by using an array LINE with the following format: 

Location Contents 

LINE(l) THISblSbSA 

LINE (2) MPLEbLINEb 

LINE (3) OFbTEXT.bb 

LINE (4) 

where b represents a space. The last word (in this 
example LINE (4)) is set to an integer zero to signify the 
end of the line of text. 
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SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Arra^ 7 " for definitions and arra" 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 


Mnemonic 


SPECS [ 1 ) 




SPECS [1 3) 




SPECS (2) 




SPECS [14) 




SPECS (3) 




SPECS [15) 




SPECS {4) 




SPECS [16) 




SPECS (5) 




SPECS[17) * 


FONTB 


SPECS {6) 




SPECS[1S) * 


FONTH 


SPECS (7) 




SPECS[19) * 


SPACER 


SPECS IS) 




SPECS [20) * 


ROTATE 


SPECS (9) 
SPECS HO) 




SPECS[21) * 
SPECS (22) * 


FONTNO 
XSTART 


SPECS[11) * 


TOOL 


SPECS (23) * 


YSTART 


SPECS(J2) * 


CCTAPE 







NOTE; SPECS [20) is set relative to the horizontal. 

For example, SPECS [20) set equal to 0.0 specifies 
a horizontal line of text; SPECS [20) set equal to 
90.0 specifies a vertical line of text. SPECS[20) 
may be set to any angle. See the appropriate 
post-processor writeup for any restrictions on line 
rotation. 

Routines Used: SIGNON, WRGHT 
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D. 



Example 



C 
C 
C 

C 

c 

c 
c 



c 
c 



DIMENSION SPECS(30), LINE(3) 

DATA LINE (1 )/10HRAND0M TIT/,LINE(2)/3HTLE/ 

SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) = 1. 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) = 99. 

SPECIFY FONTB.FONTH (INCHES) 

SPECS(17) = 0.2 

SPECS(18) = 0.2 

SPECIFY SPACER (INCHES) 

SPECS(19) = 0.0 

SPECIFY ROTATE (DEGREES) 

SPECS(20) = 0.0 

SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21 ) - 1 . 

SPECIFY XSTART, YSTART (INCHES) 

SPECS(22) = 2.5 

SPECS(23) = 1.0 

SPECIFY RULE FOR TITLE 

CENTERED ABOUT XSTART 

RULE = 2. 

SETUP ZERO WORD AFTER TITLE 

LINE(3) = 

CALL TITLEG (RULE.LINE.SPECS) 



on 

< 



Reference 
Point 



RANDOM TITLE 



CO 



XSTART 



(22T 



See the appropriate post-processor writeup for the definition of the 
reference point and the dimensions of the plotting area. 
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Subroutine SYMKEY 

Purpose 

To construct a plot symbol and a horizontal line of text. 

Method 

The routine constructs the plot symbol and begins the line of text 
immediately to the right of the plot symbol. The X ordinate (inches) 
of a specified point on the line (left, center, right) is SPECS (22); 
the Y ordinate is S?ECS(23). 

Restrictions 

A line of text cannot exceed 1060 alphanumeric characters. 

Usage 

A. FORTRAN call statement 

CALL SYMKEY (RULE,»H..., SPECS) 

or 
CALL SYMKEY WLE, L1NE,SPECS) 

B. Description of call list arguments 

RULE A floating-point variable which specifies which point on 
the line(s) of text is used with XSTART and YSTART for 
positioning the line. RULE may be either 1., 2., or 3. 
according to the following table: 

RULE - 1. The specified point on the line of text is 
the lower left corner of the plot symbol. 

RULE - 2. The specified point is at the lower center 
of the line of text, 2nd symbol. 

RULE = 3. The specified point on the line of text is 

the lower right corner of the last character. 

"H... Array containing alphanumeric text. It is usually implied 
by Hollerith literals. The Hollerith literal may be simu- 
lated by using an array LINE with the following format: 

Location Content 

LINE(l) THISblSbSA 

• LINE (2) MPLEbLINEb 

LINE (3) OFbTEXT.bb 

LINE (4) 

where b represents a space. The last word (in this 
example LINE (4)) is set to an integer zero to signify the 
end of the line of text. 



IV-9.13 



SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it; 



c. 



Parameter 


Mnemonic 


Parameter 


Mnemonic 


SPECS {1) 




SPECS (13) 




SPECS (2) 




SPECSIU) 




SPECS (3) 




SPECS ( 15 J 




SPECS [4) 




SPECS (16) * 


STOBOL 


SPECS [5) 




SPECS(17) * 


FONTB 


SPECS {6) 




SPECS(U) * 


FONTH 


SPECS (7) 




SPECS(19) * 


SPACER 


SPECS (S) 




SPECS (20) 




SPECS (9) 




SPECS(2J) * 


FONTNO 


SPECS(10) 




SPECS (22) * 


XSTART 


SPECS(U) * 


TOOL 


SPECS (23) * 


YSTART 


SPECS (12) * 


CCTAPE 






Routines Used: TITLE, 


SIGNON.WRGHT 
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Example 



C 
C 
C 

C 
C 
C 



DIMENSION SPECS(30) 
cDcrnrv mni /nddmai i v omp\ 

■- ' ' I UVk yilVIM U1L.I. I Vlll*/ 



^i i_\s x i I 



SPECS(11 ) = 1 . 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS( 12) = 99. 

SPECIFY SYMBOLTYPE (1-24) 

SPECS(16) = 6. 

SPECIFY FONTB, FONTH (INCHES) 

SPECS(17) = 0.2 

SPECS(18) = 0.2 

SPECIFY SPACER (INCHES) 



n n 



SPECS' 1 9^ 

SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 

SPECIFY XSTART, YSTART (INCHES) 

SPECS(22) = 2=0 

SPECS(23) = 3.5 

SPECIFY RULE SO XSTART REFERS 

TO LOWER LEFT-HAND CORNER OF SYMBOL KEY 

RULE = 1 . 

CALL SYMKEY (RULE, 11H SYMBOL KEY, SPECS) 



Reference \^ 
Point 




Q SYMBOL KEY 



See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine DECVAL 
Purpose 



To construct, to the number of decimal places specified, a 
numerical value along an arbitrary reference line. 

Method 

The routine rounds and constructs the value to the specified number 
of decimal places immediately above the reference line. The X 
ordinate (inches) of a specified point on the line (left, center, right) 
iaSPECS(22). The Y ordinate is SPECS (23) . SPECS (20) specifies 
the rotation angle of the reference line with respect to the 
horizontal. 

Usage 

A. FORTRAN call statement 

CALL DECVAL (RULE, l/ALUE,SPECS) 

B. Description of call list arguments 

RULE A floating-point variable which specifies which point on 
the line(s) of text is used with XSTART and YSTART for 
positioning the line. RULE may either be 1., 2., or 3. 
according to the following table: 

RULE - 1. The specified point on the line of text is 

the lower left corner of the first character. 

RULE - 2. The specified point is at the lower center 
of the line of text. 

RULE - 3. The specified point on the line of text is 

the lower right corner of the last character. 

#H... Array containing alphanumeric text. It is usually implied 
by Hollerith literals. The Hollerith literal may be simu- 
lated by using an array LINE with the following format: 

Location Contents 

LINE(l) THISblSbSA 

LINE (2) MPLEbLINEb 

LINE(3) OFbTEXT.bb 
LINE (4) 

where b represents a space. The last word (in this 
example LINE (4)) is set to an integer zero to signify the 
end of the line of text. 
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VALUE The floating-point value (single precision) to be constructed. 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 


Mnemonic 


SPECS( 7) 




SPECSi 15) 




SPECS [2) 




SPECS [16) 




SPECS {3) 




SPECSI17) * 


FONTB 


SPECS (4) 




SPECS(1Z) * 


FONTH 






SPECS(19) * 


SPACER 


SPECS [6] 




SPECS120) * 


ROTATE 


SPECS (7) 




SPECS(21) * 


FONTNO 


SPECS [8] 




SPECS (22) * 


XSTART 


SPECS (9) 




SPECS (23) * 


YSTART 


SPECS (10) 




SPECS (24) 




SPECS [11) * 


TOOL 


SPECS (25) 




SPECS tf 2) * 


CCTAPE 


SPECS(26) 




SPECS (13) 




SPECS (27) 




SPECS [14] 




SPECS(2S) * 


DECPLS 



NOTE: SPECS (20) is set relative to the horizontal. For 

example, SPECS (20) set equal to 0.0 specifies a hori- 
zontal line of text; SPECS (20) set equal to 90.0 
specifies a vertical line of text. SPECS (20). may be 
set to any angle. See the appropriate post-processor 
writeup for any restrictions on line rotation. 

C. Routines Used: DECBCD, TITLEG, SIGNON, WRGHT 
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Example 



C 
C 
C 

C 
C 
C 

c 

c 
c 



DIMENSION SPECS(30) 
SPECIFY TOOL (NORMALLY ONE) 

SPECS(ll) ■ 1. 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS(12) =99. 

SPECIFY FONTB, FONTH (INCHES) 

SPECS(17) = 0.2 

S0ECS(18) = 0.2 

SPECIFY SPACER (INCHES) 

SPECS(19) s 

SPECIFY ANGLE'OF LINE ROTATION (DEGREES) 

SPECS(20) = 0.0 

SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) - 1. 

SPECIFY XSTART, YSTART (INCHES) 

SPECS(22) =3.5 

SPECS(23) = 1.5 

SPECIFY NUMBER OF DECIMAL PLACES 

SPECS(28) = 2. 

SPECIFY RULE SO THAT XSTART, YSTART 

REFERS TO LOWER RIGHT CORNER OF LINE 

RULE = 3. 

VALUE =123.45 

CALL DECVAL (RULE, VALUE, SPECS) 









123. 


45 


Reference ' 


CO 
CM 


XSTART 






Point 




(22) 







See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine SIGVAL 
Purpose 



To construct, to the number of significant figures specified, a 
numerical value along an arbitrary reference line. 



Method 

The routine rounds and constructs the value to the specified number 
of significant figures immediately above the reference line. The X 
ordinate (inches) of a specified point on the line (l»ft» center, right) 
isSPECS(22). The Y ordinate is SPECS (23) . SPECS (20) specifies 
the rotation angle of the reference line with respect to the horizontal. 

The routine scales the constructed value (sets a value IPOWER) if the 
given value lies outside the range: 

.1 < | VALUE | < 10 (d+1) 

where d is the number of significant figures specified (SPECS (29)). 
Three examples best describe the scaling procedures. 

Example 1 - if VALUE equals 0.0072546671 and four significant digits 
are specified, the routine would construct .7255 and set 
IPOWER equal to ^2. 

Example 2 - if VALUE equals 72.546671 and four significant digits are 
specified, the routine would construct 72.55 and set 
IPOWER equal to 0. 

Example 3 - if VALUE equals 72546.671 and four significant digits are 
specified, the routine would construct 7255 and set 
IPOWER equal to 1. 

Restrictions 

None. 

Usage 

A. FORTRAN call statement 

CALL SIGVAL (RULE,l/ALUE,IPOWER,SPECS) 

B. Description of call list arguments 

RULE A floating-point variable which specifies which point on 
the line(s) of text is used with XSTART and YSTART for 
positioning the line. RULE may either be 1., 2., or 3. 
according to the following table: 

RULE - 1. The specified point on the line of text is 

the lower left corner of the first character. 

RULE ■ 2. The specified point is at the lower center 
of the line of text. 
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#H... 



RULE = 3. The specified point on the line of text is 

the lower right corner of the last character. 



Array containing alphanumeric text. It is usually implied 
hv Hollerith literals * The Hollerith literal aa' w be simu- 
lated by using an array LINE with the following format: 



Location 

LINE(l) 
LINE (2) 
LINE (3) 
LINE (4) 



Contents 

THISblSbSA 

MPLEbLINEb 

OFbTEXT.bb 





where b represents a space. The last word (in this 
example LINE (4)) is set to an integer zero to signify the 
end of the line of text. 

VALUE The floating-point value (single precision) to be constructed. 

JP0WER The scale factor determined by the routine to denote scaling 
of the constructed value. The value returned is a FORTRAN 
fixed-point integer. 



SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



Parameter 


Mnemonic 


Parameter 
SPECS {16) 


Mnemonic 


SPECS (1) 




SPECS [2) 




SPECS (J 7) * 


FONTB 


SPECS (3) 




SPECS{18) * 


FONTH 


SPECS [4) 




SPECSi 1 9) * 


SPACER 


SPECS (5) 




SPECS {20} * 


ROTATE 


SPECS {6) 




SPECS(27) * 


FONTNO 


SPECS {7) 




SPECS [22] * 


XSTART 


SPECS {8) 




SPECS (23) * 


YSTART 


SPECS [9) 




SPECS {24) 




SPECS [10) 




SPECS (25) 




SPECS{11) * 


TOOL 


SPECS {26) 




SPECSU2) * 


CCTAPE 


SPECS (27) 




SPECSi 13) 




SPECS {28) 




SPECS{14) 




SPECS (29) * 


SIGFIG 


SPECS (75) 









NOTE: SPECS {20) is set relative to the horizontal. For 

example, SPECS {20). set equal to 0.0 specifies a hori- 
zontal line of text; SPECS [20) set equal to 90.0 
specifies a vertical line of text. SPECS (20) may be 
set to any angle. See the appropriate post-processor 
writeup for any restrictions on line rotation. 

C. Routines Used: DECVAL, XSCAL2, DECBCD, TITLEG, SIGN0N, WRGHT 
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D. Example 



dimension specs(30) 
c specify tool (normally one) 

specs(ii ) = 1 . 
c specify intermediate file number 

SPECS(12) = 99. 
C SPECIFY FONTB, FONTH (INCHES) 

SPECS(17) = 0.2 

SPECS(18) = 0.2 
C SPECIFY SPACER (INCHES) 

SPECS(19) = 0.0 
C SPECIFY ANGLE OF LINE ROTATION (DEGREES) 

SPECS(20) = 0.0 
C SPECIFY FONT TYPE (NORMALLY ONE) 

SPECS(21) = 1. 
C SPECIFY XSTART, YSTART (INCHES) 

SPECS(22) = 2.0 

SPECS(23) =1.0 
C SPECIFY NUMBER OF SIGNIFICANT FIGURES 

SPECS(29) = 4. 
C SPECIFY RULE 

RULE = 1 . 

VALUE = .001234 

CALL SIGVAL (RULE, VALUE, IPOWER, SPECS) 



NOTE: IPOWER IS SET BY SIGVAL TO -2. 



1234 



Reference 
Point 




See the appropriate post-processor writeup for the definition of 
the reference point and the dimensions of the plotting area. 
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Subroutine GDSEND 



Dsl m.io a 

To terminate plotting. 
Method 

Places an end of plotting code on the intermediate file. 
Restrictions 



V 

V 

v. 

V 
V 
V 

v, 
v 

V. 



mu uc wins xasu iiiuiliuk kjixx. any cans to tne pxot routine alter 



this call will not be plotted. 
Usage 

A. FORTRAN call statement 
CALL GDSEND (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



C. 
D. 



Parameter 

SPECS (J) 
SPECS (2) 
SPECS [3) 
SPECS (4) 
SPECS (5) 
SPECS [6) 



Mnemonic 



Routines Used: SIGNON, WRGHT 

Example 

DIMENSION SPECS (30) 
C SPECIFY INTERMEDIATE FILE NUMBER 
SPECS(12) = 99. 
CALL GDSEND (SPECS) 



Parameter 

SPECS (7) 
SPECS[8) 
SPECS [9) 
SPECS (10) 
SPECS(11) 
SPECS (12) 



Mnemonic 



* CCTAPE 
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Subroutine NXTFRM 
Purpose 

To initiate a new frame. 
Method 

The method differs with each plotting device. 

Restrictions 
None 



Usage 



A. FORTRAN call statement 
CALL NXTFRM (SPECS) 

B. Description of call list arguments 

SPECS An array containing plot construction parameters. Reference 
Table 1 under "The SPECS Array" for definitions and array 
format. This routine requires the SPECS parameters indicated 
below by an * to be specified prior to calling it: 



D. 



Parameter Mnemonic 

SPECSIU 
SPECS (2) 
SPECS (3) 
SPECS [4) 
SPECS (5) 
SPECS (6) 

Routines Used: SIGNON, WRGHT 

Example 

DIMENSION SPECS (30) 

SPECIFY INTERMEDIATE FILE NUMBER 

SPECS (12) = 99. 

CALL NXTFRM (SPECS) 



Parameter 

SPECS 17) 
SPECS [8) 
SPECS (9) 
SPECS(?0) 
SPECS [1 7) 
SPECSl 12) 



Mnemonic 



* CCTAPE 



Programming note: Be sure to reset the zone values (SPECS (24), 
SPECS [251, SPECS (2677 SPECS[27 \ ) . 
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printer postprocesso r 



Routine Name 

PRINTR 

Purpose 

PRINTR processes an intermediate file, specified by SPECS ( / 2 ) A , and pro- 
duces one or more plots on the line printer. Since it is inexpensive and pro- 
vides speedy results, PRINTR is ideal for plot program debugging. 

Plotting Device Description 

A. Device type : Standard computer line printer with at least 130 
printable characters and with the option to print 66 lines per page. 

B. Accuracy : The line printer has fixed printing positions. There are 
10 print positions per inch across the page (X direction) and 6 
print positions per inch down the page (Y direction) . 

C. Plotting Area : The printer postprocessor has a maximum plotting 

area of 106 inches in the X direction by 11 inches in the Y direction. 
The first 6 inches (X direction) is right adjusted on the printer 
page and is printed only if used by the plot program. The rest of 
the plotting area is broken up into 13 inch sections (9 inches for 
the last section). Each section represents one computer page, and 
the program prints only up to the last page used by the plot program. 

D. Reference Point : The Reference Point for PRINTR is located 6 inches 
from the left side of the maximum plotting area (X axis) and at the 
bottom of the maximum plotting area (Y axis). Therefore, from the 
reference point, the maximum plotting area is: 

_6 .1 x 1 10 ° inches 
<_ Y <_ 11 inches 

(This is the same definition as for the small Cal Comp plotter.) 



SPECS (J 2) = 99 for the current CDC 6400 implementation. 
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E. Plotter speed ; Not applicable. 

F . Options : None 

Restrictions 

1. Your program must not use file, TAPE99. 

2. You must not use files TAPE18, TAPE19, TAPE20, TAPE21 , TAPE22, or 
TAPE23 for anything other than scratch storage. 

Method 

A. PRINTR is an absolute overlay. It replaces and destroys the user's 

program. 

B. In core page images : The -6 inch strip and a 2 page print image are 
held in core. When the program processes a point on a page not held 
in core, the 2 page print image is written on one of the intermediate 
files TAPE20, TAPE21 , TAPE22, or TAPE23. The 2 page core image cor- 
responding to the point being processed is then read into core. 
Therefore, plots requiring over 2 pages (26 inches, not including 
the -6 inch strip) will take much more time to process. 

C. Order of processing : PRINTR processes points in the following order: 

1. Line segments - grids, axes and connected points 

2. Plot symbols 

3. All annotation 

Files TAPE18 and TAPE19 store the symbol and annotation information 
to defer their processing. 

D. Annotation : Since the printer has only one size and spacing for 
characters the following conventions are used: 

1. Horizontal lines: The position of the first non-blank character 
is determined and then the rest of the characters are strung out 
in consecutive columns irrespective of the given character size. 

2. Vertical lines: The order of the characters are reversed (to 
make the line readable) and then the position of the first 
bottom nonblank character is determined and the rest of the 
characters are then strung out above each other irrespective 
of the given character size. 



V-1.2 



3. Imbedded blanks count as a space but do not overprint other 
plot lines. 

4. Out of bounds error messages are not printed as long as at 
least one character is within the plot area. 

Usage 

A. PRrNTR for debugging ; To debug your plots with PRINTR, make your 
calls just like you would for CALCOMP and then execute PRINTR. 
Remember that the lettering may not correspond exactly to your CALCOMP 
plots. Dense grids tend to clutter the plot. See the example for 
control card usage. 

B. PRINTR for final plots ; PRINTR can be used to make very flexible 
and good looking printer plots. When using PRINTR for this purpose, 
note the following restrictions: 

1. Set the character size to correspond to the print character size 
and insure proper spacing between lines 

a. for horizontal lines use: 

SPECS(17) = 0.1 
SPECS(18) = 0.111 
SPECS(19) = 0.0 

b. for vertical lines use: 

SPECS(17) = 0.166 
SPECS(IS) = 0.133 
SPECS(19) = 0.0 

2. Do not use dense grids (i.e., six grid lines per inch). 

C. Symbols : According to the following table, a number of character is 



chosen 


to represent 


each 


symbol 


type. 






Symbol 


Character 


Symbol 


Character 


Symbol 


Character 





. 


9 






9 


17 


G 


1 


1 


10 









18 


H 


2 


2 


11 






A 


19 


I 


3 


3 


12 






B 


20 


J 


4 


4 


13 






C 


21 


K 


5 


5 


14 






D 


22 


L 


6 


6 


15 






E 


23 


M 


7 


7 


16 






F 


24 


N 


8 


8 
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Calcomp Postprocessor 



Routine Name 



CALCOMP 



Purpose 

CALCOMP processes an intermediate file, specified by SPECSIJ2) 1 , and 
produces a binary file suitable for the Calcomp plotter. 

Plotting Device Description 

A. Device type : The Model 663 Calcomp Plotter is an incremental pen and 
ink plotting device. The plotter may be driven on-line, as the IBM 
360 does at the University, or it may be driven off-line via a magnetic 
tape unit. There are eight basic pen movements, shown in Figure 1 
below, in addition to the ability of raising or lowering the pen. 
Figure 2 below shows an example of an approximation of an oblique 
straight line using the eight basic increments. 



005" 



1 





Figure 1 Figure 2 

Eight Basic Pen An approximation to the oblique 

Movements straight line 

B. Accuracy : The Model 565 Plotter is accurate to .0025 inch. 

C Plotting Area and Reference Point : The Calcomp postprocessor allows 
a maximum plotting area of 106 inches in the X direction by 11 inches 
in the Y direction for each frame. Care should be taken to allow a 
border of at least .1 inch at the extremeties of the Y direction as 



SPECS (] 21 - 99. for CDC 6400 implementation. 



V-2.1 



there are limits switches at each end which have a variation of 
about .1 inch. See Figure 3 below for a diagram of the plotting 
area and the definition of the reference point. 




Reference 
Point 



Figure 3 



F. 



Plotter speed ; 

1. Pen speed: 2.2 inches per second. 

2. Pen up or down: .01 second per pen up 

.05 second per pen down. 
Options : 

1. Pen colors: SPECS(JJ) , tool, specifies the pen color according 
to the following chart: 



SPECS(IJ) tool 



1. 

2. 
3. 
4. 



Pen color 

Black 
Red 
Blue 
Green 



Restriction s 

1. 



2. 



Method 



Your program must not use file TAPE99 (however you must specify 
it on your program card) . 

You must not use TAPE96. (You must NOT specify this file on 
your program card.) 



CALCOMP is an absolute overlay. It replaces and destroys the user's 
program. 



V-2.2 



Usage 

A. Annotation : You have a choice of two different character fonts. 
SPECS (27) specifies which of these fonts is desired. See Figures 4 
and 5 for an examples of these fonts. 

For well formed letter using font 1 (with automatic spacing), you 
should use multiples of 0.1 inches for SPECS(77) , FONTB, and SPECS{1S), 
FONTH. SPECS! 79), SPACER, should be 0.0 

Font 2 does not have automatic spacing. For well formed letters, use 
whole multiples of the following values for SPECS (17), SPECS{1S), and 
SPECS (79) (FONTB, FONTH, and SPACER): 

SPECS {17) =0=04 (FONTB) 
SPECS { 7 8) =0.06 (FONTH) 
SPECS { 79) =0.02 (SPACER) 

B. Symbol : The symbol type is given by SPECS! 76). See Figure 6 for 
the symbols associated with each symbol type. 

c - Binary Plot Deck : CALC0MP will produce an absolute binary^ plot deck. 
Each frame will have binary sequencing in column 80 starting with one. 

When you get your plot deck back (it will be filed with the regular 
punched output), do the following: 

1. Take off the picture cards (cards with Job Number and Sequence 
Number) . 

2. Mark the deck with a felt pen to later identify it (i.e., the 
date run, number of frames, and any identification title). 
There is nothing more frsutrating and useless than a pile of 
unmarked binary plot decks which contains one deck you need to 
replot. 

3. Add the following two cards to the deck: 

a. turn over a white job card and punch the following: 
Col. 

1 10 16 

•/ PLOT NNNN.NAME (NNNN - Job Number) 

You may write any special requests on this card (i.e., Ball 
point). This card goes in front of your plot deck. 

b. Punch an "I" in column 80 (No, you don't punch the quotes.) 
This card goes in back of your plot deck. 

4. Submit deck to IBM 360. 



Absolute binary cards are binary cards without a checksum and no 
mandatory 7-9 punch in column one. 
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figure h 
Font 1 



A 




01„ /02 



c. a E. F 



06 



Lj 07 l I 10 1 11 kjl2 [\lS I 

M.N.0..P.Q.R 



14 



22 



s 



23 



24 



U» V* W» X 



28 



Y.Z.0. 1.2.3 



36 



4 c c 7 

I 37 ) 40 k /* 41 / 

^Z. 

45 46 'I 47 / 50 




42 \ / 43 \ / 44 



9 



] 



52 



53 54 55 S 56 57 



EEEEE 



Ee 



2> SPECS (17) - l-0\ 

SPECS (18) -. O.Q,\ 
' SPECS (19) » 0.0 \ 



.9 .8 .7 .6 .5 .4 .3 .2 .1 
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45 46 



+ 

$ 

EEEE 



Figure 5 
Font 2 
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kJo7 Mxo 111 U« T\ 13 L 



12 I >> 13 I 14 



27 I 1 30 



53 54 55 7 56 D 57 




. N. D. P. Q. R 

\_J*23 I 24 k_j25 X/26 UsJ 

Z 1 2 3 

31 C 32 V w/33 -L 34 *- 35 ^-^36 

± S.„ 6. 7., 8. 9 



43 > — ^44 



/IN* 7 /50 [^ 51 I 



52 



E E E E e « 

.4 .36 .32 .28 .24 .20 .16 .12 .08 .04 SPECS(17) 

.6 .54 .48 .42 .36 .30 .24 .18 .12 .06 SPECS(18) 

2 .18 .16 .14 .12 .10 .08 .06 .04 .02 SPECS(19) 
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Figure 6 
Symbol Table 
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Control Card Usape 

A. CDC 6400 Implementation 

The purpose of this section Is to demonstrate how to use the Graphical 
Display system on the 6400 and possibly answer some of the questions which 
often arise. 

1. Which of the three FORTRAN compilers, RUN, FUN, FTN, should be used 
to compile the main program? 

The Graphical Display System was compiled under the RUN compiler. 
Since RUN compiled and FUN compiled subroutines are interchangable, 
the main program may be compiled under either of these compilers. 
The Graphical Display System may not be used with programs compiled 
under FTN. 

2. Where are the Graphical Display Subroutines found? 

The Graphical Display Routines are currently on the common file 
GDSLIB. The routine SELECT searches the LGO file and adds the 
needed plot routines to the end of the LGO file. 

3. Where are the post-processing routines? 

Both post-processing routines are on the system library. They may 

be called in and executed with one control card. (See example below.) 

4. Control Card Examples 
Example 1 . 

To compile a plot program and execute both the PRINTR and CALCOMP 
post-processors . 



"CDC 6400 Job Card" 

RUN » S - Compile 

CLDR,LIB=GDSLIB. 
PRINTR. 
CALCOMP. 

7-8-9 card A card with 7>8) and 9 punched in 

column one. 

PROGRAM PLOT (INPUT , OUTPUT , TAPE9 9 ) 

7-8-9 card 

any data 
6-7-8-9 card A card with 6,7,8 and 9 punched in column one. 
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Example 2 

To compile a plot program and execute only the PRINTR poet-proceaaor. 

"Job Card" 

RUN,S. 

CLDR,LIB=GDSLIB. 

PRINTR. 

7-8-9 card 

PROGRAM PLOT (INPUT, OUTPUT, TAPE99) 

7-8-9 card 

any data 
6-7-8-9 card 

Example 3 

Load a binary deck and execute only the Calcomp post-processor . 



"Job Card" 
CLDR,I,LIB=GDSLIB. 

CALCOMP . 
7-8-9 card 



(Binary Deck) 
7-8-9 (17B) A level 17 7-8-9 card. A card with a 7-8-9 

punched in column one, a 1 punched in column 2 and 
a 7 punched in column 3, and a B in column 4. 
(any data) 
6-7-8-9 card 
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Diagnostics 

Currently, all diagnostics come from the post-processing routines. We 
are working on a general diagnostic routine which may be used in conjunc- 
tion with the Graphical Display Subroutines. Until this routine is finished, 
and possibly even after that, the best diagnostics come from the plot itself. 
If the user runs into any trouble while using GDS, he should check the bulle- 
tin board outside the machine room for the schedule of the plotting consultant. 

Good Luck!!! 
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ZONEL 



XLNGTH 



ZONER, 

n*nfri 1 

iZONET 

JJ25) 



YLNGTH 

0) 




ZONEB 
(24) 



(1) 
The reference point 

See post-processor write-ups for the actual position of the Reference Point 
on any particular plotter. 

Figure 1 

A Sample Plot Illustrating SPECS Parameters 



